Creates one or more users. Returns 207 Multi-Status when some users were created and others failed. Returns 409 Conflict for duplicate usernames or emails, and 422 for invalid field values.
Security
The requesting user must have the following permission to create users:
- Administration → Users → Create Users
Identifies the R365 tenant the request applies to. Required on every request.
User roles to assign. At least one role is required — an empty array is rejected with errorCode 'urn:r365:user:role-required'.
Unique identifier of the guid id.
Unique identifier of the guid id.
Unique identifier of the external location.
Unique identifier of the guid id.
Unique identifier of the entity reference long post.
Identifier of the employee record to link this user to. Supplied as a bare GUID on the request; the GET response returns it as an object with id and name.
Legal entities to scope this user to.
Unique identifier of the guid id.
Users created successfully.
Unique identifier of the user created.
Per-item failures. NOTE: the wire property is 'errors' (SuccessErrorsResponse), not 'userErrors'.
207 Multi-Status – Partial success: the response contains arrays of created users and of errors for those that could not be created.
Unique identifier of the user created.
Bad Request — a parameter value is malformed, of the wrong type, or outside its allowed range.
Unauthorized — the bearer token is missing, invalid or expired, or is not valid for the specified tenant.
Forbidden — the caller lacks the permission required for this operation.
Not Found — the requested resource does not exist, or the supplied continuation token is unknown or has expired.
Conflict — the request conflicts with the current state of the resource and cannot be applied.
Unprocessable Entity — a required parameter is missing, or a supplied parameter value is invalid.
Too Many Requests — the caller has exceeded the rate limit; retry after a short delay.
Internal Server Error — an unexpected error occurred while processing the request.