Skip to main content
POST
Create a SCIM token
Mints a token that starts with oc_scim_. It appears only in this response. Paste it and the SCIM base URL into your identity provider. See User provisioning. The plaintext token (oc_scim_…) appears exactly once, in this response. Paste it into your identity provider’s SCIM configuration with the base URL <api-origin>/scim/v2. On Cloud this needs the Scale plan or above.
Availability: Cloud · Enterprise (self-hosted). Not available on the Community edition: a self-hosted deployment needs ENTERPRISE_ENABLED=true, otherwise the endpoint answers 403 with error.type: "enterprise_license_required".

Authorizations

Authorization
string
header
required

A workspace API key (oc_…) or organization API key (oc_org_…). Workspace-scoped endpoints called with an organization key also need X-Workspace-Id.

Body

application/json
label
string
required
Maximum string length: 64
Example:

"Okta"

Response

The token

id
string
label
string
lastUsedAt
string<date-time> | null
createdAt
string<date-time>
token
string
Example:

"oc_scim_…"