API ReferenceUsers

Create Current Org User

Creates a new user in the caller's current organization and assigns the requested permissions roles. The new user receives an invitation email prompting them to set up their account. Role assignments take effect as soon as the invitation is accepted.

Authentication

AuthorizationBearer
Bearer user API key
OR
AuthorizationBasic

Basic organization-scoped API key

Headers

X-Polytomic-VersionstringRequired

Request

This endpoint expects an object.
emailstringRequired
Email address used to sign the user in and receive notifications.
role_idslist of stringsOptional
Identifiers of the permissions roles to assign to the user. Must contain at least one entry when provided.
rolestringOptionalDeprecated

Deprecated legacy role name. Use role_ids instead; setting both role and role_ids in the same request is rejected.

Response

OK
dataobject

Errors

403
Forbidden Error
422
Unprocessable Entity Error
500
Internal Server Error