---
title: "Create a new API Token for Dashboard User"
method: POST
path: "/user/tokens"
tags: ["UserApiTokens"]
---

# Create a new API Token for Dashboard User

`POST /user/tokens`

## Request body

- PostTokenFields — Environment API token required fields for creation.
  - `note` string, required — Name or note to help identify this token and its use.
  - `scopes` TokenScopes[] — Scopes assigned to an API token which they will have access to.

## Response `201`

The newly created token, with the plaintext of the token. This is the only time when this plaintext will be revealed.

- CreateTokenResponse
  - `token` TokenWithRaw, required
    - `id` string, required
    - `rawToken` string, required — The actual token created. If you do not save it, it can never be retrieved again
    - `checksum` string, required — A 6-character alpha-numeric string checksum of the random API Token. The last 6 characters of the raw token
    - `createdBy` TokenCreatedBy, required
      - `id` string, required
      - `alias` string
      - `firstName` string
      - `lastName` string
      - `email` string, email
    - `active` boolean — Only active tokens can be used.
    - `createdAt` string, date-time, required
    - `note` string
    - `projectEnvironmentId` string
    - `projectEnvironment` object
      - `id` string
    - `scopes` TokenScopes[] — Scopes assigned to an API token which they will have access to.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/dynamic/apis/dashboard-api.md) · [All operations](https://skmtc.net/dynamic/apis/dashboard-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dynamic/dashboard-api/revisions/aac826315d90/schema)