Meeting BaaSMeeting BaaS
MeetingBaas APITranscript SeekerSpeaking Bots
Getting Started/Calendar Synchronization

Maintenance

Maintain your calendar integrations, handle errors, and clean up calendar accounts

Error Handling and Troubleshooting

Common Errors

OAuth Token Expiration

Both your app's credentials (service level) and user's credentials (user level) can expire or be revoked. If this happens Calendar sync operations will start failing.

Detecting and fixing the issue
  1. You can detect this by periodically checking the calendar status using the Get Calendar endpoint
  2. You should implement a monitoring strategy using this route to detect these failures and prompt users to reconnect their calendars

When this occurs, you need to, depending on whether it is your app's credentials or the user's credentials that are expired, you have 2 choices:

User's credentials are expired

Prompt the user to reauthorize calendar access by:

  1. Updating your database to mark the calendar integration as requiring reauthorization
  2. Prompting the user to reconnect their calendar when they next access your application

Your app's credentials are expired

Reauthorize your app's credentials by:

  1. Requiring new app credentials as shown in the Setup guide and storing them in your database
  2. Patching the calendar integration with the new credentials using the Update Calendar endpoint to update your app credentials while keeping the same user credentials

Rate Limiting Considerations

Calendar APIs enforce rate limits. Meeting BaaS handles these gracefully, but if you encounter persistent sync issues, check:

  1. The frequency of your calendar operations
  2. The number of events being synced
  3. Other applications using the same OAuth credentials

For Google Workspace, you're limited to 1 million queries per day per project. For Microsoft, limits vary by subscription type.

If you're building a high-volume application, consider implementing these best practices:

  • Batch calendar operations where possible
  • Implement exponential backoff for retries
  • Monitor your API usage with logging and alerts
  • Consider using multiple projects for very high-volume needs

Maintenance and Cleanup

Removing Calendar Integrations

To remove a calendar integration, use the Delete Calendar endpoint.

curl -X DELETE "https://api.meetingbaas.com/calendars/cal_12345abcde" \
  -H "Authorization: Bearer YOUR_API_KEY"

This will:

  1. Stop syncing the calendar
  2. Cancel any scheduled recordings for events from this calendar
  3. Remove the calendar integration from your account

This operation does not revoke OAuth access. However MeetingBaaS will have completely deleted the calendar integration from your account and its records.

To completely remove access, users should also revoke access via Google or Microsoft security settings. users should also revoke access via Google or Microsoft security settings.

Next Steps

Now that you've mastered calendar synchronization:

Edit on GitHub

Webhooks

Receive real-time updates, handle errors, and maintain your calendar integrations

List Bots with Metadata GET

Next Page

On this page