Users

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.

post/api/organizations/{org_id}/users

Request

  • Base URL
    https://app.polytomic.com
  • Auth
    HTTP bearer

Path parameters

org_idstring uuid required

Unique identifier of the organization the user belongs to

Example:248df4b7-aa70-47b8-a036-33ac447e668d

Headers

X-Polytomic-Versionstring

Request body

emailstring required

Email address used to sign the user in and receive notifications

rolestring

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

role_idsstring[]

Identifiers of the permissions roles to assign to the user. Must contain at least one entry when provided.

Example request

{
  "email": "mail@example.com",
  "role": "admin",
  "role_ids": [
    "248df4b7-aa70-47b8-a036-33ac447e668d"
  ]
}

Response

OK

Example response

{
  "data": {
    "email": "mail@example.com",
    "role": "admin",
    "role_ids": [
      "248df4b7-aa70-47b8-a036-33ac447e668d"
    ]
  }
}

Changes

No recorded changes to this operation across all 51 revisions of this API.