---
title: "Create a single-owner Gateway Token"
method: POST
path: "/sites/{site_id}/gateways/{gateway_id}/token"
tags: ["Gateway Tokens"]
---

# Create a single-owner Gateway Token

`POST /sites/{site_id}/gateways/{gateway_id}/token`

Creates a token bound to a single gateway. At most one active token can exist per gateway; if one already exists, this returns 409 Conflict - rotate the token or delete it first instead.

## Path parameters

- `site_id` string, required
- `gateway_id` string, required

## Response `201`

New Token Response

- GatewayTokenResponse — Response schema for a new Gateway Token
  - `data` GatewayToken — Gateway Token
    - `id` string, uuid, required — Gateway Token ID
    - `token` string, required — Gateway Token

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `409` — Conflict
- `429` — Too Many Requests

---

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