---
title: "Create a new API token"
method: POST
path: "/api/v1/tokens/"
tags: ["tokens"]
---

# Create a new API token

`POST /api/v1/tokens/`

## Request

- Base URL: `http://localhost:3000`
- URL: `http://localhost:3000/api/v1/tokens/`
- Auth: HTTP bearer

Create a new API token

## Request body

- object
  - `name` string, required: Token name
  - `tokenType` 'USER_API_TOKEN' | 'BOT_TOKEN' | 'SERVICE_TOKEN' | 'WEBHOOK_TOKEN': Type of token to create
  - `scopes` string[]: Token scopes/permissions
  - `allowedIps` string[]: IP whitelist for token
  - `rateLimit` integer: Rate limit per minute
  - `expiresInDays` integer: Token expiration in days

## Response `200`

Default Response

- object
  - `success` true, required
  - `data` object, required
    - `token` string: Full token (only shown once)
    - `tokenId` string: Token ID
    - `tokenPrefix` string: Token prefix
    - `warning` string: Security warning
  - `meta` object, required
    - `timestamp` number, required

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `500`: Default Response

---

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