# Add

## Add

<mark style="color:green;">`POST`</mark> `https://{{account_id}}.acquire.io/api/v1/account/user`

Add a new user.&#x20;

#### Headers

| Name          | Type   | Description         |
| ------------- | ------ | ------------------- |
| Authorization | string | Bearer {{API\_KEY}} |

#### Request Body

| Name       | Type   | Description                                                                                                                  |
| ---------- | ------ | ---------------------------------------------------------------------------------------------------------------------------- |
| name       | string | Name of the user.                                                                                                            |
| email      | string | Email of the user. Must be unique.                                                                                           |
| password   | string | Password of the user (can be changed later).                                                                                 |
| roles      | array  | Array of integers. The role ID(s) the user will be assigned to.                                                              |
| department | array  | Array of integers. The department ID(s) the user will be assigned to. Pass empty array if not assigning any department to it |

{% tabs %}
{% tab title="200 " %}

```
{
  "data": {
    "user": {
      "firstName": "",
      "lastName": "",
      "name": "testing User",
      "email": "testings@acquire.io",
      "type": "user",
      "status": "active",
      "dateCreated": "2021-03-22T10:37:36.981Z",
      "lastLoginId": null,
      "parentId": null,
      "ownerId": null,
      "phone": null,
      "photo": null,
      "inviteToken": null,
      "language": null,
      "clientId": null,
      "clientAppId": null,
      "clientAuthorizer": null,
      "stateId": null,
      "countryId": null,
      "meta": {
        "onboard_setup": {
          "welcome": false,
          "install": false,
          "setupMail": false,
          "setupVoip": false,
          "setupSocialApp": false,
          "setupAppStore": false
        }
      },
      "id": 24,
      "clientPermissions": null,
      "departments": [
        null
      ],
      "roles": [
        {
          "id": 1,
          "roleName": "Administrator",
          "permissions": [
            "*/*"
          ],
          "permissionType": null,
          "meta": null
        }
      ]
    },
    "success": true,
    "message": "New User added Successfully."
  }
}
```

{% endtab %}
{% endtabs %}

## Body(raw)

```
{
  "name": "testing User",
  "email": "testings@acquire.io",
  "password": "Acquire@2020",
  "departments": [
    1
  ],
  "roles": [
    1
  ],
  "additionalProp1": {}
}
```
