curl --request POST \
--url https://api.us.cr4ce.com/user \
--header 'Accept: <accept>' \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"first_name": "Ada",
"last_name": "Lovelace",
"password": "correct-horse-battery-staple",
"email": "ada.lovelace@example.com",
"roles": [
"AbCdEfGh"
],
"preferences": {
"broadcast_emails": true,
"notification_emails": true,
"notification_sms": false
},
"user_fields": {
"fJkIjGmB": "Test value"
}
}
'{
"analytics_cookies": true,
"broadcast_emails": true,
"comments": "Jane Doe (2025-05-21T15:25:39+00:00): User comment",
"confirmation": "Confirmed",
"confirmed_at": "2018-04-17T00:00:00Z",
"created_at": "2024-06-24T06:34:30Z",
"created_by": "manual",
"email": "jane.doe@example.com",
"first_name": "Jane",
"language": {
"code": "en_GB",
"language": "English (United Kingdom)"
},
"last_name": "Doe",
"marketing_cookies": true,
"mobile": "",
"name": "Jane Doe",
"necessary_cookies": true,
"notification_emails": true,
"notification_sms": true,
"preferences": {
"broadcast_emails": true,
"notification_emails": true,
"notification_sms": true
},
"roles": [
{
"slug": "AbCdEfGh",
"link": "https://api.eu.cr4ce.com/role/AbCdEfGh",
"name": {
"en_GB": "Applicant"
}
},
{
"slug": "CdEfGhIj",
"link": "https://api.eu.cr4ce.com/role/CdEfGhIj",
"name": {
"en_GB": "Program manager"
}
}
],
"slug": "EfGhIjKl",
"social_sharing": true,
"updated": "2026-06-26T07:50:46Z",
"user_fields": [
{
"slug": "GhIjKlMn",
"link": "https://api.eu.cr4ce.com/field/GhIjKlMn",
"label": {
"en_GB": "<p>Title</p>"
},
"title": {
"en_GB": "Title"
},
"value": "Ms",
"translated": {
"en_GB": ""
}
},
{
"slug": "IjKlMnOp",
"link": "https://api.eu.cr4ce.com/field/IjKlMnOp",
"label": {
"en_GB": "<p>user file upload</p>"
},
"title": {
"en_GB": "user file upload"
},
"value": "https://api.eu.cr4ce.com/file/",
"token": "",
"translated": {
"en_GB": ""
}
}
]
}{
"message": "<string>",
"status_code": 400
}{
"message": "<string>",
"status_code": 401
}{
"message": "<string>",
"status_code": 403
}{
"message": "<string>",
"status_code": 422,
"errors": {}
}{
"message": "<string>",
"status_code": 429
}{
"status": "Maintenance in progress"
}Users
Create user
Create a user.
POST
/
user
curl --request POST \
--url https://api.us.cr4ce.com/user \
--header 'Accept: <accept>' \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"first_name": "Ada",
"last_name": "Lovelace",
"password": "correct-horse-battery-staple",
"email": "ada.lovelace@example.com",
"roles": [
"AbCdEfGh"
],
"preferences": {
"broadcast_emails": true,
"notification_emails": true,
"notification_sms": false
},
"user_fields": {
"fJkIjGmB": "Test value"
}
}
'{
"analytics_cookies": true,
"broadcast_emails": true,
"comments": "Jane Doe (2025-05-21T15:25:39+00:00): User comment",
"confirmation": "Confirmed",
"confirmed_at": "2018-04-17T00:00:00Z",
"created_at": "2024-06-24T06:34:30Z",
"created_by": "manual",
"email": "jane.doe@example.com",
"first_name": "Jane",
"language": {
"code": "en_GB",
"language": "English (United Kingdom)"
},
"last_name": "Doe",
"marketing_cookies": true,
"mobile": "",
"name": "Jane Doe",
"necessary_cookies": true,
"notification_emails": true,
"notification_sms": true,
"preferences": {
"broadcast_emails": true,
"notification_emails": true,
"notification_sms": true
},
"roles": [
{
"slug": "AbCdEfGh",
"link": "https://api.eu.cr4ce.com/role/AbCdEfGh",
"name": {
"en_GB": "Applicant"
}
},
{
"slug": "CdEfGhIj",
"link": "https://api.eu.cr4ce.com/role/CdEfGhIj",
"name": {
"en_GB": "Program manager"
}
}
],
"slug": "EfGhIjKl",
"social_sharing": true,
"updated": "2026-06-26T07:50:46Z",
"user_fields": [
{
"slug": "GhIjKlMn",
"link": "https://api.eu.cr4ce.com/field/GhIjKlMn",
"label": {
"en_GB": "<p>Title</p>"
},
"title": {
"en_GB": "Title"
},
"value": "Ms",
"translated": {
"en_GB": ""
}
},
{
"slug": "IjKlMnOp",
"link": "https://api.eu.cr4ce.com/field/IjKlMnOp",
"label": {
"en_GB": "<p>user file upload</p>"
},
"title": {
"en_GB": "user file upload"
},
"value": "https://api.eu.cr4ce.com/file/",
"token": "",
"translated": {
"en_GB": ""
}
}
]
}{
"message": "<string>",
"status_code": 400
}{
"message": "<string>",
"status_code": 401
}{
"message": "<string>",
"status_code": 403
}{
"message": "<string>",
"status_code": 422,
"errors": {}
}{
"message": "<string>",
"status_code": 429
}{
"status": "Maintenance in progress"
}Authorizations
Headers
Body
application/json
User create payload.
- Option 1
- Option 2
Response
User created, or an existing user added to the account.
Two outcomes share this status code:
- New user — a new user record is created. The body is the full user resource and the
Locationheader links to it. - Existing user — the email or mobile already belongs to a user on another account, so that user is added to the current account instead. The body is a confirmation message and no
Locationheader is returned.
- Option 1
- Option 2
Detailed user fields returned only for a single user.