# POST /api/teams

> Team - Add New Team

Every member id is validated against the users table before the team is stored: an id which is unknown, deleted or not a staff user is rejected and nothing is written.

- **Endpoint:** `POST /api/teams`
- **Group:** Team
- **Since:** v1.0.0
- **Defined in:** `RestApi/Controllers/TeamController.php`

## Headers

| Field | Type | Description |
| --- | --- | --- |
| `authtoken` | String | Authentication token, generated from admin area |

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `title` | String | yes | Mandatory Team title |
| `members` | String|Number[] | yes | Mandatory Staff user ids, as an array or a comma separated list |

## Request example

```bash
curl -X POST "https://yoursite.com/index.php/api/teams" \
  -H "authtoken: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "title": "...", "members": "..." }'
```

## Responses

### Success - Success-Response:

```json
HTTP/1.1 201 Created
{ "status": 200, "messages": { "success": "The record has been saved." }, "id": 1 }
```

### Error - Invalid-Member:

```json
HTTP/1.1 400 Bad Request
{ "status": false, "messages": { "members": "Unknown or non staff user id: 99." } }
```

---

Part of the [REST API for RISE CRM](https://risecrm.themesic.com/apiguide/) documentation.
Full page: https://risecrm.themesic.com/apiguide/team/create-team/