> For the complete documentation index, see [llms.txt](https://developers.docstudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.docstudio.com/api-documentation/api-methods/account-domains/mass-create-users.md).

# Mass create users

Use this endpoint to upload the completed XLSX template and create users in bulk. Use the same file structure as the template from [Download Example File](https://support.docstudio.com/docstudio-docs/docstudio-for-developers/api-documentation/api-methods/account-corporate-users/download-example-file).

| Endpoint         |                                       |
| ---------------- | ------------------------------------- |
| Method           | POST                                  |
| Request URL      | `/api/v1/account/{accountUuid}/users` |
| **Headers**      |                                       |
| Authorization \* | Bearer TOKEN                          |
| Content-Type \*  | multipart/form-data                   |
| **Request**      |                                       |
| accountUuid \*   | Target account UUID                   |
| Body \*          | XLSX binary                           |

### How it works

1. Download the example XLSX file.
2. Fill the file with users, roles, permissions, and mailbox assignments.
3. Upload the completed file to create users in bulk.

### Request example

```http
POST https://api.platform_address_here/api/v1/account/3fa85f64-5717-4562-b3fc-2c963f66afa6/users
Authorization: Bearer {token}
Content-Type: multipart/form-data

file=@corporate-users.xlsx
```

### Response

The endpoint returns `200` if the import request succeeds.

### Response status codes

| Code | Description    |
| ---- | -------------- |
| 200  | Success        |
| 401  | Not authorized |
| 403  | Forbidden      |

### Related topics

* [Account Corporate Users](https://support.docstudio.com/docstudio-docs/docstudio-for-developers/api-documentation/api-methods/account-corporate-users)
* [Download Example File](https://support.docstudio.com/docstudio-docs/docstudio-for-developers/api-documentation/api-methods/account-corporate-users/download-example-file)