API Reference/Calendars

Create Calendar

Integrates a new calendar with the system using OAuth credentials. This endpoint establishes a connection with the calendar provider (Google, Microsoft), sets up webhook notifications for real-time updates, and performs an initial sync of all calendar events. It requires OAuth credentials (client ID, client secret, and refresh token) and the platform type. Once created, the calendar is assigned a unique UUID that should be used for all subsequent operations. Returns the newly created calendar object with all integration details.

POST
/calendars

Authorization

x-meeting-baas-api-key<token>

API key for authentication

In: header

Request Body

application/jsonRequired
oauth_client_idRequiredstring
oauth_client_secretRequiredstring
oauth_refresh_tokenRequiredstring
platformRequiredstring

Fields with value "simple" parse as Kind::Simple. Fields with value "fancy" parse as Kind::SoFancy.

Value in: "Google" | "Microsoft"
raw_calendar_idstring | null
curl -X POST "https://api.meetingbaas.com/calendars/" \
  -H "x-meeting-baas-api-key: <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "oauth_client_id": "string",
    "oauth_client_secret": "string",
    "oauth_refresh_token": "string",
    "platform": "Google",
    "raw_calendar_id": "string"
  }'

{
  "calendar": {
    "email": "string",
    "google_id": "string",
    "name": "string",
    "resource_id": "string",
    "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
  }
}