Create Partner User
Creates a new user in the specified organization and assigns the requested permissions roles.
These endpoints accept a partner key or an Organization-scoped key derived from a partner key. An Organization-scoped key can access users only in its own Organization.
To manage users with a user API key, use the current-Organization endpoints
under /api/organization/users.
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 partner API key
Path parameters
org_id
Unique identifier of the organization the user belongs to
Headers
X-Polytomic-Version
Request
This endpoint expects an object.
email
Email address used to sign the user in and receive notifications
role_ids
Identifiers of the permissions roles to assign to the user. Must contain at least one entry when provided.
roleDeprecated
Deprecated legacy role name. Use role_ids instead; setting both role and role_ids in the same request is rejected.
Response
OK
data
Errors
403
Forbidden Error
422
Unprocessable Entity Error
500
Internal Server Error
