Create a person. Send the fields of the new row in JSON. You must be an administrator. You cannot create an active person who is not a bot when the user limit is reached. The route checks role, contract_type, country, locale, display_date_format, two_factor_authentication and expiration_date. The expiration date cannot be in the past. The email must be valid. Only one person who is not a bot can use an email. The route ignores the preview account fields. For a bot, the response also gives its access_token.
POST
/data/persons
curl
curl -X POST "http://api.example.com/data/persons" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@example.com",
"password": "securepassword123",
"role": "user",
"active": true,
"contract_type": "permanent",
"two_factor_authentication": "none",
"expiration_date": "2025-12-31",
"is_bot": false
}'import requests
url = "http://api.example.com/data/persons"
headers = {
"Authorization": "Bearer YOUR_API_TOKEN",
"Accept": "application/json",
"Content-Type": "application/json"
}
params = {}
payload = {
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@example.com",
"password": "securepassword123",
"role": "user",
"active": true,
"contract_type": "permanent",
"two_factor_authentication": "none",
"expiration_date": "2025-12-31",
"is_bot": false
}
response = requests.post(
url,
headers=headers,
params=params,
json=payload
)
response.raise_for_status()
if response.content:
print(response.json())
Request examples
{
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@example.com",
"password": "securepassword123",
"role": "user",
"active": true,
"contract_type": "permanent",
"expiration_date": "2025-12-31",
"is_bot": false,
"country": "FR"
}
Response examples (201)
{
"id": "a24a6ea4-ce75-4665-a070-57453082c250",
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@example.com",
"role": "user",
"active": true,
"contract_type": "permanent",
"two_factor_authentication": "none",
"country": "FR",
"access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:30:00Z"
}