How far into the future are calendar events synced in the API?

4 weeks.

How long does Recall store calendar data?

Recall will retain calendar data up to 60 days in the past for both Calendar V1 & V2 integrations. Calendar events past 60 days are automatically removed and not available via the API.

How do I add a bot to a calendar event via email?

You may prefer a user flow where you can invite an email (eg. [email protected]) to any meeting, and the bot will join.

You can accomplish this with the Recall Calendar Integration by:

1. Creating an email on your end (e.g. [email protected])
2. Connecting that user to the Recall calendar integration
3. Setting the calendar integration to automatically record every meeting on the calendar

This will assign a meeting bot to all events that your chosen email address is invited to.

Does the calendar integration support team/shared calendars?

Currently only the primary calendar of connected users are supported.

Are Microsoft Exchange On-premise Calendars supported?

Currently Microsoft Exchange On-premise calendars are not supported.

How is the meeting_url populated when there are multiple links on the calendar invite?

In the case when a calendar event has multiple meeting links populated, the default meeting_url is populated according to this order of precedence:

• The default meeting url (often defined by the click to join meeting button)
• The meeting URL in the description/body

In the case when there are multiple meeting links in the description, the order of precedence is as follows: Zoom, Google Meet, Teams, Webex, GoTo Meeting.

📘

With Calendar V2, you can override the meeting_url when calling the Schedule Bot For Calendar Event endpoint to select the meeting URL you'd like the bot to join.

Troubleshooting

invalid_scope error

Even after setting up your OAuth client and successfully integrating calendars, you may see an invalid_scope error:

"invalid_scope(detail: None of the supported calendar scopes(['https://www.googleapis.com/auth/calendar.events.readonly', 'https://www.googleapis.com/auth/calendar.readonly', 'https://www.googleapis.com/auth/calendar.events', 'https://www.googleapis.com/auth/calendar']) present in response(['https://www.googleapis.com/auth/userinfo.email', 'openid']).)"

This happens when the user is connecting their calendar for the first time, and doesn't select the checkbox to allow your app to view their calendar events.

To resolve this, they should reconnect their calendar while ensuring to check this box.