Setup

Authentication: Get your OAuth credentials

To start syncing calendars, you'll need two sets of credentials:

1. Your App's Credentials (Service Level)

• For Outlook: Your app's Microsoft Client ID and Client Secret
• For Google Workspace: Your app's Google Client ID and Client Secret

2. End User's Credentials (User Level)

• OAuth refresh token obtained when user grants calendar access to your app

Required OAuth Scopes

For Google Workspace:

• https://www.googleapis.com/auth/calendar.readonly - To read calendar and event data
• https://www.googleapis.com/auth/calendar.events.readonly - To access event details

For Microsoft Outlook:

• Calendars.Read - To read calendar and event data
• Calendars.ReadWrite - Required if you need to modify calendar events

Optional: List Raw Calendars

Before syncing calendars, you can use the List Raw Calendars endpoint to view all your user's available calendars. This is particularly useful when a user has multiple calendars and you need to choose which ones to sync.

Request Example

curl -X GET "https://api.meetingbaas.com/calendars/raw" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "google",
    "refresh_token": "USER_REFRESH_TOKEN",
    "client_id": "YOUR_GOOGLE_CLIENT_ID",
    "client_secret": "YOUR_GOOGLE_CLIENT_SECRET"
  }'

Response Example

{
  "calendars": [
    {
      "id": "primary",
      "name": "Main Calendar",
      "description": "User's primary calendar",
      "is_primary": true
    },
    {
      "id": "team_calendar@group.calendar.google.com",
      "name": "Team Calendar",
      "description": "Shared team meetings",
      "is_primary": false
    }
  ]
}

Create a Calendar Integration

Create a new calendar integration by calling the Create Calendar endpoint with the previously obtained credentials.

Request Example

curl -X POST "https://api.meetingbaas.com/calendars" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "google",
    "refresh_token": "USER_REFRESH_TOKEN",
    "client_id": "YOUR_GOOGLE_CLIENT_ID",
    "client_secret": "YOUR_GOOGLE_CLIENT_SECRET",
    "raw_calendar_id": "team_calendar@group.calendar.google.com"  // Optional
  }'

If the raw_calendar_id parameter is not provided, Meeting BaaS will sync the user's primary calendar by default.

Response Example

{
  "id": "cal_12345abcde",
  "provider": "google",
  "status": "syncing",
  "created_at": "2023-08-15T14:30:00Z",
  "raw_calendar_id": "team_calendar@group.calendar.google.com",
  "calendar_name": "Team Calendar"
}

Managing Calendars

Once authenticated, you can manage your calendars as described in the Managing Calendar Events guide.

Calendar integrations can have the following status values:

• syncing - Initial sync in progress
• active - Calendar is actively syncing
• error - Sync encountered an error (check the error_message field)
• disconnected - The calendar connection has been terminated