Only show these results:

Automatic Emails

Nylas by default automatically sends emails to all parties for confirming and cancelling bookings.

Confirmation emails to organizers use the same language as the organizer's browser configuration. For attendees, the emails use English as the default language.

Deactivate automantic emails using the confirmation_emails_to_host and confirmation_emails_to_guests booking configuration options. This guide goes over building custom email workflows on top of Scheduler after deactivating default email notifications.

Deactivating Automatic Emails

Use Scheduler configurations as well as the API to deactivate automatic emails. The configuration options for confirmation_emails_to_host and confirmation_emails_to_guests are Boolean data types. These default to True.

Scheduler Configuration Method

The configuration options in the code below within the booking object display the deactivated confirmation emails.

    nylas.scheduler.show({
auth: {
accessToken: "<ACCESS_TOKEN>"
},
style: {
tintColor: "#32325d",
backgroundColor: "white"
},
defaults: {
event: {
title: "30-min Coffee Meeting",
duration: 30
}
},
booking: {
confirmation_emails_to_host: false,
confirmation_emails_to_guests: false
},
reminders: [{
delivery_method: "webhook",
delivery_recipient: "both",
webhook_url: "https://cc899d4c831f.ngrok.io/webhook",
time_before_event: 20160
}]
});

API Method

In this curl request, the example shows the deactivated confirmation emails in the two configuration options.

curl --location --request PUT 'https://api.schedule.nylas.com/manage/pages/{page_id}' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--header 'Content-Type: application/json' \
--data-raw '{
"access_tokens": [
"<ACCESS_TOKEN>"
],
"config": {
"booking": {
"confirmation_emails_to_guests": false,
"confirmation_emails_to_host": false,
"confirmation_method": "automatic",
"scheduling_method": "round-robin-maximize-fairness"
},
"calendar_ids": {
"<ACCOUNT_ID>": {
"availability": [
"<CALENDAR_ID>"
],
"booking": "<CALENDAR_ID>"
}
},
"event": {
"duration": 30,
"location": "Virtual",
"title": "30 Minute Coffee Meeting"
}
}
}'

Custom Thank You Page Booking Flow

After configuring a Scheduling Page with a custom thank you page, the query string parameters from the booking flow help to customize, build, and send your own booking confirmation email.

In the link example below, the reschedule and cancel booking links use the same formatting.

https://{domain}/{page_slug}/reschedule/{edit_hash}
https://{domain}/{page_slug}/cancel/{edit_hash}

Best Practices

Save the Nylas Event ID (event_id) associated with the booking in addition to sending your own configuration email using the data from a custom thank you redirect.

Webhooks

In the Nylas Dashboard, you can configure your application to receive event.updated and event.deleted Webhook events. When you receive an event change, follow the steps below.

  1. Match the modified event_id to an existing booking. Ignore it if it's not the same.
  2. Retrieve the most recent copy of the event object using the Nylas GET /events/{id} API.
  3. Send a cancellation email for the booking if the event status is cancelled or if each event.participants[].status is no.

Keep in Mind

Check for cancellations via the Nylas API as bookings can be cancelled using the Scheduling Page as well as the booking's cancellation URL.

Participants can also remove the events from their calendars to cancel. In this case, there is no delivery notification using the thank_you_redirect booking configuration.