---
title: "Create a client-side token"
method: POST
path: "/client-tokens"
tags: ["Client tokens"]
---

# Create a client-side token

`POST /client-tokens`

## Request

- Base URL: `https://sandbox-api.paddle.com`
- URL: `https://sandbox-api.paddle.com/client-tokens`
- Auth: HTTP bearer

Creates a new client-side token.

If successful, your response includes a copy of the new client-side token entity.

## Request body

- ClientTokenCreate: Represents a client-side token entity.
  - `name` string, required: Short name of this client-side token. Typically unique and human-identifiable.
  - `description` string: Short description of this client-side token. Typically gives details about what the token is used for and where it's used.

## Response `201`

The request has succeeded and a new resource has been created as a result.

- object
  - `data` ClientToken, required: Represents a client-side token entity.
    - `id` string, required: Unique Paddle ID for this client-side token entity, prefixed with `ctkn_`.
    - `token` string, required: A client-side token, prefixed with `test` or `live` depending on the environment of your account. Pass as the `token` parameter when initializing Paddle.js to authenticate.
    - `name` string, required: Short name of this client-side token. Typically unique and human-identifiable.
    - `description` string, required: Short description of this client-side token. Typically gives details about what the token is used for and where it's used.
    - `status` 'active' | 'revoked', required: Status of this client-side token.
    - `revoked_at` string, date-time, required: RFC 3339 datetime string.
    - `created_at` string, date-time, required: RFC 3339 datetime string of when this entity was created. Set automatically by Paddle.
    - `updated_at` string, date-time, required: RFC 3339 datetime string of when this entity was updated. Set automatically by Paddle.
  - `meta` Meta, required: Information about this response.
    - `request_id` string, required: Unique ID for the request relating to this response. Provide this when contacting Paddle support about a specific request.

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-02-02** (v1) `9ba8be0f2006`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/paddlehq/apis/paddle-api/changes/client-tokens/post.md)

---

[API](https://skmtc.dev/paddlehq/apis/paddle-api.md) - [All operations](https://skmtc.dev/paddlehq/apis/paddle-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paddlehq/apis/paddle-api/revisions/bbc0c72039c8?raw)