Create a session - Sessions - API Reference

POST

https://api.us.nylas.com/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.

Works with an API key or an IAM API key with the sessions.create permission.

Request body

Create a new scheduling session

configuration_idstring

The ID of the Scheduler Configuration object for the session. If you're using slug, configuration_id is not required.

Example: "AAAA-BBBB-1111-2222"

slugstring

The slug of the Scheduler Configuration object for the session. You can use slug instead of configuration_id.

Example: "my-page-slug"

time_to_livenumber

The time to live for the session in minutes. The maximum value is 30.

Default: 5

Example: 10

Responses

request_idstring

The request ID.

dataobject

curl --compressed --request POST \ --url "https://api.us.nylas.com/v3/scheduling/sessions" \ --header 'Accept: application/json' \ --header 'Authorization: Bearer <NYLAS_API_KEY>' \ --header 'Content-Type: application/json' \ --data '{ "configuration_id": "<SCHEDULER_CONFIGURATION_ID>", "time_to_live": 10 }'