Skip to content
Last updated

Manage calendar provider connections for syncing events and enabling auto-join.

GEThttps://api.aitronos.com/v1/meeting-buddy/calendar/connections

List all connected calendar providers for the authenticated user, including sync status and event counts.


Returns

Returns a list of calendar connection objects.

Calendar Connection Object

FieldTypeDescription
credential_idstringUnique credential ID
providerstringCalendar provider (google_calendar, outlook_calendar, zoom, apple_calendar)
account_emailstring or nullConnected account email
is_activebooleanWhether the connection is active
last_sync_atstring or nullLast successful sync time (ISO 8601)
event_countintegerNumber of synced events from this connection
cURL
curl -s -X GET "https://api.aitronos.com/v1/meeting-buddy/calendar/connections" \
  -H "Authorization: Bearer $ACCESS_TOKEN" | python3 -m json.tool

Connect a calendar

POSThttps://api.aitronos.com/v1/meeting-buddy/calendar/connections

Connect a new calendar provider. For OAuth-based providers (Google Calendar, Outlook Calendar, Zoom), this returns an authorization URL to complete the OAuth flow. For Apple Calendar, provide credentials directly.

Request Body

provider string required

Calendar provider to connect. Valid values: google_calendar, outlook_calendar, zoom, apple_calendar.

credentials object optional

Required for Apple Calendar. Must contain apple_id and app_specific_password.


Returns

For OAuth providers, returns an authorization URL and state token. For Apple Calendar, returns the created connection object.

cURL (OAuth)
curl -s -X POST "https://api.aitronos.com/v1/meeting-buddy/calendar/connections" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"provider": "google_calendar"}' | python3 -m json.tool

Disconnect a calendar

DELETEhttps://api.aitronos.com/v1/meeting-buddy/calendar/connections/{credential_id}

Disconnect a calendar provider and remove all associated synced events.

Path Parameters

credential_id string required

The credential ID of the calendar connection to disconnect.


Returns

Returns no content on success (204).

cURL
curl -s -X DELETE "https://api.aitronos.com/v1/meeting-buddy/calendar/connections/utcred_abc123" \
  -H "Authorization: Bearer $ACCESS_TOKEN"