---
title: "Create Subscriber guest token"
method: POST
path: "/api/fabric/guests/tokens"
tags: ["Subscriber Tokens"]
---

# Create Subscriber guest token

`POST /api/fabric/guests/tokens`

Creates a [Subscriber](/docs/platform/subscribers) Guest Token. Authenticate this request with your project's API token.

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_, _Messaging_, _Fax_, or _Video_.

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Request body

- SubscriberGuestTokenCreateRequest
  - `allowed_addresses` Uuid[], required — List of up to 10 UUIDs representing the allowed Fabric addresses.
  - `expire_at` integer — A unixtime (the number of seconds since 1970-01-01 00:00:00) at which the token should no longer be valid. Defaults to 'two hours from now'
  - `region` 'us-central' — A routing override that controls which regional cluster the SDK connects to.
  - `ch` 'us-central' — A direct routing override specifying the regional cluster endpoint, set as the `ch` claim in the SAT JWE header.

## Response `201`

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

- SubscriberGuestTokenCreateResponse
  - `token` string, jwt, required
  - `refresh_token` string, jwt, required

## Other responses

- `401` — Access is unauthorized.
- `404` — The server cannot find the requested resource.
- `422` — The request contains invalid parameters. See errors for details.
- `500` — An internal server error occurred.

---

[API](https://skmtc.net/signalwire/apis/signalwire-rest-api.md) · [All operations](https://skmtc.net/signalwire/apis/signalwire-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signalwire/signalwire-rest-api/revisions/05c5164b85c7/schema)