---
title: "Create Client Token to join a room."
method: POST
path: "/rooms/{room_id}/actions/generate_join_client_token"
tags: ["Rooms Client Tokens"]
---

# Create Client Token to join a room.

`POST /rooms/{room_id}/actions/generate_join_client_token`

Synchronously create an Client Token to join a Room. Client Token is necessary to join a Telnyx Room. Client Token will expire after `token_ttl_secs`, a Refresh Token is also provided to refresh a Client Token, the Refresh Token expires after `refresh_token_ttl_secs`.

## Path parameters

- `room_id` string, uuid, required

## Request body

- CreateRoomClientTokenRequest
  - `token_ttl_secs` integer — The time to live in seconds of the Client Token, after that time the Client Token is invalid and can't be used to join a Room.
  - `refresh_token_ttl_secs` integer — The time to live in seconds of the Refresh Token, after that time the Refresh Token is invalid and can't be used to refresh Client Token.

## Response `201`

Create room client token response.

- object
  - `data` object
    - `token` string
    - `token_expires_at` string, date-time — ISO 8601 timestamp when the token expires.
    - `refresh_token` string
    - `refresh_token_expires_at` string, date-time — ISO 8601 timestamp when the refresh token expires.

## Other responses

- `403` — Forbidden

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) · [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api/llms.txt) · [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api/revisions/e32d46c5945b?raw)