---
title: "Create SCIM token"
method: POST
path: "/v1/sso-connections/{id}/scim/tokens"
tags: ["sso-connections"]
---

# Create SCIM token

`POST /v1/sso-connections/{id}/scim/tokens`

## Request

- Base URL: `https://api.brixsignage.com`
- URL: `https://api.brixsignage.com/v1/sso-connections/{id}/scim/tokens`
- Auth: HTTP bearer

Creates a new SCIM provisioning token for this SSO connection. The token value is shown exactly once, in this response. A connection can have at most 5 live tokens at a time. Only a workspace Owner, signed in as a person, can create one; the token stops working if that person is no longer an Owner. This action cannot be taken while impersonating another user.

## Path parameters

- `id` string, required

## Response `201`

Success.

- object
  - `data` object, required
    - `id` string, required
    - `token` string, required: The SCIM bearer token. Shown only here; store it now.
    - `baseUrl` string, required

## Other responses

- `401`: Missing, expired or revoked bearer token.
- `403`: You do not hold the permission for the whole workspace (a grant at one location, or in a franchise workspace, is not enough). `owner_required`: only a workspace Owner, signed in as a person, can create a SCIM token (not an API key). The token stops working if that person is no longer an Owner.
- `404`: No such connection in this workspace.
- `409`: `too_many_tokens`: the connection already has 5 live tokens.
- `5XX`: Server error. The body carries a `requestId` to quote to support.

---

[API](https://skmtc.dev/brixsignage/apis/brix-api.md) · [All operations](https://skmtc.dev/brixsignage/apis/brix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/brixsignage/apis/brix-api/revisions/02fd3665dc7d?raw)