---
title: "Create a session"
method: POST
path: "/v3/scheduling/sessions"
tags: ["Sessions"]
---

# Create a session

`POST /v3/scheduling/sessions`

Creates a new short-lived session that you can pass to the Scheduling Component to enforce user
authentication. Your request must include the ID of an existing Configuration object.

## Request body

- object
  - `configuration_id` string — The ID of the Scheduler Configuration object for the session. If you're using `slug`, `configuration_id` is not required.
  - `slug` string — The slug of the Scheduler Configuration object for the session. You can use `slug` instead of `configuration_id`.
  - `time_to_live` number — The time to live for the session in minutes. The maximum value is `30`.

## Response `200`

Create a new scheduling session

- object
  - `request_id` string — The request ID.
  - `data` object — The response object.
    - `session_id` string — The ID of the session

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `429` — Rate Limit
- `504` — Provider Failure

---

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