---
title: "Create guest"
method: POST
path: "/guests"
---

# Create guest

`POST /guests`

Creates a new guest with access to a specific externally accessible app and returns a login URL to share with them.

## Request body

- CreateGuestParams
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `app` string, required — The name of the externally accessible app this guest can access.
  - `expires_in` integer — The number of seconds the guest session should last. Defaults to 72 hours.
  - `name` string — Optional display name for the guest.
  - `redirect_url` string — Where to redirect the guest after they log in. Defaults to the app's subdomain.

## Response `200`

OK

- CreateGuestResponse
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `guest` Guest, required
    - `app` string, required — The name of the app this guest can access.
    - `created_at` string, date-time, required — When the guest was created.
    - `id` string, required — The unique identifier for the guest.
    - `name` string — Optional display name for the guest.
  - `login_url` string, required — The URL to share with the guest for logging in.
  - `login_url_expires_at` string, date-time, required — When the login URL expires.

## Other responses

- `default` — Error

---

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