Calendar V2 FAQ
Calendar V2 FAQ
Grouping recurring calendar events
You may want to group all instances of a recurring event for tracking and applying recording preferences on these events.
If you're using the Calendar V2 integration, we recommend using these fields to group instances of a recurring events:
seriesMasterId
- Microsoft OutlookrecurringEventId
- Google Calendar
Since these are calendar platform-specific, you can find them in the raw
attribute of the calendar event object.
What if multiple bots from different apps using Recall try to join the same meeting?
Deduplication keys are scoped to a given Recall account. This means that multiple bots should have no trouble joining the same meeting, even if both companies are using the same deduplication key scheme.
Why is the platform_email
null
when I create the calendar?
platform_email
null
when I create the calendar?The platform_email
may be null briefly when you create the calendar. This is because the calendar sync (which populates the platform_email
) happens asynchronously after the calendar is created.
If you need the email immediately, we'd recommend using the OAuth token to call the calendar platform (Google or Microsoft) APIs directly to retrieve the user email.
Why did a calendar fail to connect with an invalid_scope
error?
invalid_scope
error?Calendars can fail to connect due to invalid_scope
for one of two reasons:
- The OAuth client is setup incorrectly (e.g. missing necessary scopes in the OAuth client setup)
- The end user did not grant the necessary permissions when connecting their account. This can happen when they forget to click a checkbox during the OAuth flow.
To resolve this, the user should reconnect their calendar while ensuring to check the checkbox.
Why Did the Calendar ID Associated with an Event ID Change?
Calendar events can have their calendar IDs changed on rare occasions due to a process called event ownership transfer. This happens when the ownership of an event is moved from one calendar to another, resulting in the same event ID being linked to a new calendar ID.
Such changes can occur unexpectedly, especially when events are managed by users within the same organization. If your system depends on a stable calendar ID, you may need to account for this scenario in your workflows.
Why is the onlineMeeting.joinUrl
populated on an event, but the meeting_url
is not?
onlineMeeting.joinUrl
populated on an event, but the meeting_url
is not?This can happen when the meeting URL is a wrapped link or is a link to a meeting on an unsupported platform.
Updated about 1 month ago