---
title: "Create a signed user token"
method: POST
path: "/users/{user_id}/tokens"
tags: ["Tokens"]
---

# Create a signed user token

`POST /users/{user_id}/tokens`

Provides a mechanism for having Surge create a signed token for embeds instead of signing with your own signing key.

## Path parameters

- `user_id` string, required — The user for which the token represents authentication.

## Request body

- TokenParams — A request to create a token
  - `duration_seconds` integer — For how many seconds the token should be accepted. Defaults to 15 minutes.

## Response `201`

Created token

- TokenResponse — Response when token has been created successfully
  - `token` string — The created token.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/surgeapi/apis/surge.md) · [All operations](https://skmtc.net/surgeapi/apis/surge/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/surgeapi/surge/versions/b5b0b6f62245/schema)