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

Update Configuration

Updates the specified Configuration object.

When you make a PUT request, Nylas replaces all data in the nested object with the information included in your request. For more information, see Updating objects.

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.

configuration_id*string

The ID of the Configuration object to access.

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
PUThttps://api.us.nylas.com/v3/grants/nyla%40example.com/scheduling/configurations/{configuration_id}

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.

configuration_idrequiredstring

The ID of the Configuration object to access.

Loading editor...

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