# POST /api/users

> Users - Add New User

- **Endpoint:** `POST /api/users`
- **Group:** Users
- **Since:** v1.0.0
- **Defined in:** `RestApi/Controllers/UsersController.php`

## Headers

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

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `first_name` | string | yes | Mandatory User first name |
| `last_name` | string | yes | Mandatory User last name |
| `email` | string | yes | Mandatory User email |
| `user_type` | string | yes | Mandatory User type (staff, client, lead) |
| `password` | string | no | Optional User password |
| `phone` | string | no | Optional User phone |
| `job_title` | string | no | Optional Job title |
| `gender` | string | no | Optional Gender (male, female, other) |
| `client_id` | number | no | Optional Client ID (required for client user_type) |
| `role_id` | number | no | Optional Role ID (for staff) |
| `status` | string | no | Optional Status (active, inactive) default: active |
| `address` | string | no | Optional Address |
| `skype` | string | no | Optional Skype ID |

## Request example

```bash
curl -X POST "https://yoursite.com/index.php/api/users" \
  -H "authtoken: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "first_name": "...", "last_name": "...", "email": "...", "user_type": "..." }'
```

## Responses

### Success - Success-Response:

```json
HTTP/1.1 200 OK
{
  "status": true,
  "message": "User add successful."
}
```

---

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