Only show these results:

Custom Confirmation and Cancelation Emails

Nylas Scheduler allows you to disable the automatic emails sent to all parties when bookings are confirmed and canceled using the confirmation_emails_to_host and confirmation_emails_to_guests booking configuration option. See the Whitelabeling Guide for more details on how to disable these automatic email notifications.

This guide walks through how you can build your own custom email workflows on top of Scheduler if you've disabled the default email notifications.

Disable Automatic Emails

You can disable automatic emails as part of the booking flow. Email confirmations are automatically sent to the guest and the host. Scheduler gives you the option to disable either of these emails.

There are two ways to disable automatic emails.

  • Using the Scheduler configuration
  • Using the API

Disable Using Scheduler Configuration

Use the configuration options:

  • confirmation_emails_to_host: true/false
  • confirmation_emails_to_guests: true/false

These default to true.

        nylas.scheduler.show({
auth: {
// Account access_token with active calendar scope
accessToken: ""
},
style: {
// Style the schedule editor
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
}]
});
});

Disable Using the API

When you create scheduling pages using the API, you can disable automatic emails.

Use the configuration options:

  • confirmation_emails_to_host: true/false
  • confirmation_emails_to_guests: true/false
POST https://schedule.api.nylas.com/manage/pages

{
"name": "string",
"slug": "string",
"access_tokens": [
"string"
],
"config": {
"appearance": {
"thank_you_redirect": "https://mysite.com/booking/thanks"
...
},
"booking": {
"confirmation_method": "automatic",
"confirmation_emails_to_host": false,
"confirmation_emails_to_guests": false
},
...
},
}

Custom Thank You Page

Configure your scheduling pages with the config.appearance.thank_you_redirect set to a URL on your web application. When a booking is created, rescheduled, or canceled the visitor will be sent from the booking flow to this URL, with the following query string parameters:

parameter type description
start_time unix timestamp Start time of the event
end_time unix timestamp End time of the event
tz string IANA time zone database formatted string (e.g. America/New_York).
page_slug string Page slug where the booking took place
name string The name provided when booking the event
email string The email provided when booking the event
location string Location description of the event
edit_hash string Unique edit hash that can be used to modify this booking
event_id string Nylas Event id created for this booking
additional_values object key-value pairs for additional fields on the booking form
*custom query parameters string any additional query parameters when visiting the scheduling page

You can use this information to build and send your own booking confirmation email. The reschedule and cancel booking links are formatted in this way, where domain is your custom domain (launching later this year) or schedule.nylas.com:

https:////cancel/

https:////reschedule/

In addition to sending your own configuration email using this data, your service should save the Nylas Event ID (event_id) associated with the booking.

Webhooks

Configure your application via the Nylas dashboard to receive event.updated and event.deleted webhook events. When you receive an event change, perform the following steps:

  • Does the modified event_id match a booking? If not, ignore it.
  • Retrieve the latest copy of the event object via the Nylas GET /events/:id API.
  • If the event status is cancelled or if every event.participants[].status is no, send a cancelation email for the booking.

It's important to check for cancellations via the Nylas API, because bookings can be canceled using the booking page and the booking's cancelation URL, but they can also be canceled by participants removing the events from their calendars. In that case, the scheduler is never shown and we cannot deliver a notification via the thank_you_redirect.