User.com REST API Docs # Bulk users import
You can import your users from CSV files using REST API. The CSV file requires the usage of standardized attribute names for the header row. You can check the progress of your import with a GET request.
It is possible to trigger automations for imported users by adding trigger_automations parameter.
Example CSV file: example_users_import.csv that should be added within "content-type: multipart/form-data:" header
| Attributes | Type | Required | Description |
|---|---|---|---|
| trigger_automations | string / int | no | The parameter allowing triggering automations for imported users. Possible values are: 1 / 0 / True / true / False / false |
| tags | string | no | The key allowing to add tags to all imported users. Each tag has to be in one string and separated by comma. |
| lists | string | no | The key allowing to add lists to all imported users. Each list has to be in one string and separated by comma. |
POST /users/import/
# Request
- CURL
- JavaScript
- PHP
- Python
curl --location --request POST 'https://<your_app_subdomain>.user.com/api/public/users/import/' \
--header 'Content-Type: multipart/form-data' \
--header "Authorization: Token <your_64_char_api_key>" \
--header 'Accept: */*; version=2"' \
--form 'input_file=@"path/to/file.csv"'
# Response
{
"success": true,
"data": {
"id": "49b85a88-68c7-4236-bf04-9b10c4896510",
"total_count": 10999,
"succeeded": 10999,
"failed": 0,
"started_at": "2022-06-07T07:51:22.826756Z",
"finished_at": "2022-06-07T07:51:47.226386Z",
"author": 1,
"rows_with_errors": []
}
}