Only show these results:

Manually Add Meeting Details

Read conferencing details from the events endpoint across both Google and Exchange with our conferencing field. Get full CRUD access to Google’s conferenceData field using the Nylas conferencing field.

Conference Sync

Supported Providers

CRUD for conferencing supported for Google GCal and GSuite. Microsoft Exchange and is READ-ONLY.

Create a Conference Event

To create a conference event for Google, add the conferencing object to /events. For this example, we will use Zoom.

Review the Events endpoint to see an example of other providers.

Zoom Meeting

  • provider - Must be entered as Zoom Meeting
  • details - Object that contains the meeting information.
    • url - Zoom URL of the meeting.
    • meeting_code - Zoom meeting code.
    • password - Zoom meeting password.
    • phone - Zoom meeting phone number. The country code must be included.

Create Conference Event Request

You can create events with metadata and notifications.

curl --location --request POST 'https://api.nylas.com/events' \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"title": "Birthday Party",
"location": "Roller Rink",
"calendar_id": "9ev16mzqlwux5vrxai6s2t4uf",
"status": "confirmed",
"busy": true,
"read_only": false,
"participants": [
{
"name": "Dorothy Vaughan",
"email": "[email protected]"
},
{
"name": "Katherine Johnson",
"email": "[email protected]"
},
{
"name": "Hedy Lamarr",
"email": "[email protected]"
}
],
"description": "Lets celebrate",
"when": {
"start_time": "1608241500",
"end_time": "1608245100"
},
"conferencing": {
"provider": "Zoom Meeting",
"details": {
"url": "https://us02web.zoom.us/j/****************",
"meeting_code": "213",
"password": "xyz",
"phone": [
"+11234567890"
]
}
}
}'

Create Conference Event Response

The response includes the conferencing details object. The details can vary by provider.

{
"account_id": "5tgncdmczat02216u7d6uypyi",
"busy": true,
"calendar_id": "9ev16mzqlwux5vrxai6s2t4uf",
"conferencing": {
"details": {
"meeting_code": "213",
"password": "xyz",
"phone": [
"+11234567890"
],
"url": "https://us02web.zoom.us/j/****************"
},
"provider": "Zoom Meeting"
},
"description": "Let's celebrate",
"ical_uid": null,
"id": "b54acjszoyhsxljnfr3lnhm2y",
"job_status_id": "73p1s2umn46ym77krav0qm8cx",
"location": "Roller Rink",
"message_id": null,
"object": "event",
"owner": "Nylas Swag <[email protected]>",
"participants": [
{
"comment": null,
"name": "Hedy Lamarr",
"email": "[email protected]",
"status": "noreply"
}
],
"read_only": false,
"status": "confirmed",
"title": "Birthday Party",
"when": {
"end_time": 1608245100,
"object": "timespan",
"start_time": 1608241500
}
}

Get Conference Event Data

Nylas will attempt to pull conference data from the conferenceData field on Google Calendar or from location/description on Exchange into the conferencing object in Nylas.

To view conference details object use the GET /events or GET /events/{event_id}.

You can view conference data for the following providers:

  • WebEx
  • GoToMeeting
  • Zoom
  • Google Meet

Conference Event Data Request

curl --location --request GET 'https://api.nylas.com/events' \
--header 'Authorization: Bearer <access_token>' \

Conference Event Data Response

Zoom Conference Details

The following is an example of the response when conference details are available.

[{
"account_id": "5tgncdmczat02216u7d6uypyi",
"busy": true,
"calendar_id": "cdv2pa13ogzd7x1fgb6bk0uy0",
"conferencing": {
"details": {
"meeting_code": "123 456 7890",
"phone": [
"+12345678901",
"+12532158782"
],
"url": "https://us02web.zoom.us/j/5668774452"
},
"provider": "Zoom Meeting"
},
"description": "\n──────────\nAda Lovelace is inviting you to a scheduled Zoom meeting.\n\nJoin Zoom Meeting\nhttps://us02web.zoom.us/j/**********\n\nMeeting ID: 123 456 7890\nOne tap mobile\n+1234567890,,**********# US (San Jose)\n+1234567890,,**********# US (Tacoma)\n\nDial by your location\n +1 123 456 7890 US (San Jose)\n +1 123 456 7890 US (Tacoma)\n +1 123 456 7890 US (Houston)\n +1 123 456 7890 US (Germantown)\n +1 123 456 7890US (Chicago)\n +1 123 456 7890 US (New York)\nMeeting ID: 123 456 7890\nFind your local number: https://us02web.zoom.us/u/*******\n\n\n──────────\n\n-::~:~::~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~::~:~::-\nPlease do not edit this section of the description.\n\nView your event at https://calendar.google.com/calendar/event?action=VIEW&eid=********&tok=******&ctz=America%2FChicago&hl=en&es=1.\n-::~:~::~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~::~:~::-",
"ical_uid": "***********@google.com",
"id": "4wa541hgeph6vje9mzzf5wrru",
"location": "https://us02web.zoom.us/j/**********",
"message_id": "3etfeskt26j5oqdt5w1ordafz",
"object": "event",
"owner": "\"[email protected]\" <[email protected]>",
"participants": [{
"comment": null,
"email": "[email protected]",
"name": "[email protected]",
"status": "noreply"
},
{
"comment": null,
"email": "[email protected]",
"name": "[email protected]",
"status": "yes"
}
],
"read_only": true,
"recurrence": {
"rrule": [
"RRULE:FREQ=WEEKLY;BYDAY=WE"
],
"timezone": "America/Los_Angeles"
},
"status": "confirmed",
"title": "Weekly 1:1",
"when": {
"end_time": 1608150600,
"object": "timespan",
"start_time": 1608148800
}
}]

Zoom Event Data

The following is an example of when conference details are not available. The information is still available as part of the location and description.

  • location - Typically includes the video URL.
  • description - Full event details
[{
"account_id": "5tgncdmczat02216u7d6uypyi",
"busy": true,
"calendar_id": "cdv2pa13ogzd7x1fgb6bk0uy0",
"description": "\n──────────\nAda Lovelace is inviting you to a scheduled Zoom meeting.\n\nJoin Zoom Meeting\nhttps://us02web.zoom.us/j/**********\n\nMeeting ID: 123 456 7890\nOne tap mobile\n+1234567890,,**********# US (San Jose)\n+1234567890,,**********# US (Tacoma)\n\nDial by your location\n +1 123 456 7890 US (San Jose)\n +1 123 456 7890 US (Tacoma)\n +1 123 456 7890 US (Houston)\n +1 123 456 7890 US (Germantown)\n +1 123 456 7890US (Chicago)\n +1 123 456 7890 US (New York)\nMeeting ID: 123 456 7890\nFind your local number: https://us02web.zoom.us/u/*******\n\n\n──────────\n\n-::~:~::~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~::~:~::-\nPlease do not edit this section of the description.\n\nView your event at https://calendar.google.com/calendar/event?action=VIEW&eid=********&tok=******&ctz=America%2FChicago&hl=en&es=1.\n-::~:~::~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~:~::~:~::-",
"ical_uid": "***********@google.com",
"id": "4wa541hgeph6vje9mzzf5wrru",
"location": "https://us02web.zoom.us/j/**********",
"message_id": "3etfeskt26j5oqdt5w1ordafz",
"object": "event",
"owner": "\"[email protected]\" <[email protected]>",
"participants": [{
"comment": null,
"email": "[email protected]",
"name": "[email protected]",
"status": "noreply"
},
{
"comment": null,
"email": "[email protected]",
"name": "[email protected]",
"status": "yes"
}
],
"read_only": true,
"recurrence": {
"rrule": [
"RRULE:FREQ=WEEKLY;BYDAY=WE"
],
"timezone": "America/Los_Angeles"
},
"status": "confirmed",
"title": "Weekly 1:1",
"when": {
"end_time": 1608150600,
"object": "timespan",
"start_time": 1608148800
}
}]

Supported Conference Providers

We can access conference data for the following providers and fields:

WebEx

  • password
  • pin
  • url

Zoom Meeting

  • meeting_code
  • password
  • url

GoToMeeting

  • meeting_code
  • phone
  • url

Google Meet

  • phone
  • pin
  • url

Keep in Mind

  • When fetching events, you might not get the conferencing object returned. Nylas will make an attempt to get the conferencing details when available.
  • CRUD is supported for Google only.
  • There is no SDK support.

What's Next?