---
title: "Create API token"
method: POST
path: "/auth/tokens"
---

# Create API token

`POST /auth/tokens`

This endpoint will create a new API Token and show it in the response body.
                     It is possible to create a comment with every token to have a reference where it is used.
                     Make sure to save the token somewhere, since you won't be able to see it again.  Requires scope `auth:write`.

## Request body

- object
  - `comment` string, required — The comment can be everything. Tip: Use something to remember where this specific token is used.
  - `scopes` string[]

## Response `200`

Successful

---

[API](https://skmtc.dev/datawrapper/apis/datawrapper-api-v3-documentation.md) · [All operations](https://skmtc.dev/datawrapper/apis/datawrapper-api-v3-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/datawrapper/datawrapper-api-v3-documentation/revisions/e190512863c7/schema)