Users
Create User
Creates a new user in the organization.
POST /api/users
Request Body
{
"email": "jane@deinkunde.com",
"firstName": "Jane",
"lastName": "Doe",
"role": "editor", // "admin", "editor", "readonly" or "responder"
"language": "en", // Optional: "de", "en" or "da"
"customerIds": ["11111111-1111-4111-8111-111111111111", "22222222-2222-4222-8222-222222222222"] // Optional: Limit access to specific customers via public IDs
}Notes:
customerIdsaccepts customer public IDs and legacy numeric IDs.customerIdsis only allowed forrole: "readonly". Sending a non-emptycustomerIdswith any other role returns400withdata.code: "customerIdsReadonlyOnly"(it used to be ignored silently, which created an organization-wide user).- Public IDs are the preferred format for new integrations.
languageis optional: the new user's starting language for the dashboard, e-mails and text messages (de,enorda). It also decides the language of the invitation e-mail. Omitted, the user gets the language of the one customer they are invited for (readonlywith a single customer), otherwise the organization's language. The user can change it later in their profile. Any other value is rejected with400.- There is no password field: the user receives an invitation e-mail and sets their own password.
Response
Returns the created user object. See Error Codes for error responses.