Skip to content
Skip to main content
POST
/v3/grants/{grant_id}/scheduling/configurations

Create Configuration

Creates a Configuration object that you use to define settings and preferences for a scheduling session.

Duplicate email notifications

If the organizer in a scheduling session is a Microsoft account user, both the organizer and all attendees might receive duplicate email notifications, including booking confirmations, rescheduling and cancellation notifications, and reminders. This is because of the way Microsoft handles email notifications. If you set notifications in Scheduler, Microsoft also sends its own notifications to the event organizer and attendees. Microsoft doesn't provide a way to disable these notifications.

Metadata as additional fields

You can add metadata fields (type: metadata) to your Configuration to store custom information about a booking. For example, you can add campaign tags or keywords to track specific bookings.

Webhook notifications include your metadata fields, but email notifications and booking forms don't display them.

NYLAS API KEY

Parameters

Path parameters

grant_id*string

ID of the grant to access. You can also use the email address associated with the grant, or use /me/ to refer to the grant associated with an access token.

Request body

appearanceany

An object that defines the appearance settings for the Scheduling Page. This field may be null if no appearance customization has been set.

availability*object

The rules that determine the available time slots for the event.

event_booking*object
namestring

The name of the Scheduling Page. If not defined, Nylas defaults to the organizer's name.

participants*array<object>

A list of participants to be included in the scheduled event. All participants' email addresses must be associated with a valid Nylas grant.

requires_session_authbooleannull

When true, the scheduling Availability and Bookings endpoints require a valid session ID to authenticate requests using the specified Configuration. This field may be null if not explicitly set on the configuration; treat null the same as false (the default behavior).

Default: false
schedulerobject
slugstringnull

The slug for the Configuration object. This is an optional, unique identifier. You can use the slug instead of the configuration_id when making requests to the Nylas Scheduling endpoints. Slugs are unique to each Nylas application. This field may be null if no slug has been set.

Responses

request_idstring

The request ID.

dataobject
POSThttps://api.us.nylas.com/v3/grants/nyla%40example.com/scheduling/configurations

Find your API key in the Nylas Dashboard under API Keys in your application settings.

grant_idrequiredstring

ID of the grant to access. You can also use the email address associated with the grant, or use /me/ to refer to the grant associated with an access token.

Loading editor...

Autocomplete and validation come from this endpoint's request schema.