Add conferencing to bookings

When organizers select a conferencing option in the Scheduler Editor, Scheduler can create conferencing details for new events. Nylas can create conferencing details for Google Meet, Microsoft Teams, and Zoom.

By default, the Scheduler Editor shows the organizer's authenticated provider (either Google Meet or Microsoft Teams) as a conferencing option. If you set up Zoom conferencing, the Scheduler Editor displays Zoom as an option as well.

Setting up automatic conference creation

Before you can create conferencing details with Scheduler, you need to have a provider auth app, and a connector for your provider with at least the following scopes:

Google: No specific scopes required
Microsoft: OnlineMeetings.ReadWrite
Zoom: meeting:write:meeting and user:read:user

If you already have a Google of Microsoft connector, you can use it to connect to Google Meet and Microsoft Teams, respectively.

For more information about creating provider auth apps and connectors, see Nylas' Provider guides.

Create Google Meet or Microsoft Teams conferences

📝 Currently, Scheduler supports same-provider conference creation for Google Meet and Microsoft Teams. For example, if an organizer authenticates with Nylas using their Google account, they can't create Microsoft Teams meetings.

Make a Create Configuration or Update Configuration request that includes the conferencing object. Specify the provider, and include an empty autocreate object.

curl --request PUT \
  --url "https://api.us.nylas.com/v3/grants/<NYLAS_GRANT_ID>/scheduling/configurations/<SCHEDULER_CONFIGURATION_ID>" \
  --header 'Accept: application/json, application/gzip' \
  --header 'Authorization: Bearer <NYLAS_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "event_booking": {
      "conferencing": {
        "provider": "Google Meet",
        "autocreate": {}
      } 
    } 
  }'

Create Zoom conferences

You can add conferencing with Zoom to Scheduler either using the Scheduler API or modifying the Scheduler Editor Component.

Add Zoom conferencing using Scheduler API

Make a Create Configuration or Update Configuration request that includes the conferencing object. Set the provider to Zoom and set autocreate.conf_grant_id to the ID of the grant you authenticated with Zoom.

curl --request PUT \
  --url "https://api.us.nylas.com/v3/grants/<NYLAS_GRANT_ID>/scheduling/configurations/<SCHEDULER_CONFIGURATION_ID>" \
  --header 'Accept: application/json, application/gzip' \
  --header 'Authorization: Bearer <NYLAS_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "event_booking": {
      "conferencing": {
        "provider": "Zoom Meeting",
        "autocreate": {
          "conf_grant_id": "<NYLAS_GRANT_ID>"
        }
      }
    }
  }'

Add Zoom conferencing using Scheduler Editor Component

To add Zoom conferencing to Scheduler using the Scheduler Editor Component, include the conferenceProviders object, and set the zoom property to the ID of the grant you authenticated with Zoom.

<NylasSchedulerEditor
  conferenceProviders = {
    'zoom': '<NYLAS_GRANT_ID>'
  }
/>