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

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

API key for authentication

In: header

Request Body

application/json

oauth_client_id*string
oauth_client_secret*string
oauth_refresh_token*string
platform*string

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

Value in"Google" | "Microsoft"
raw_calendar_id?|

Response Body

application/json

curl -X POST "https://api.meetingbaas.com/calendars/" \  -H "Content-Type: application/json" \  -d '{    "oauth_client_id": "string",    "oauth_client_secret": "string",    "oauth_refresh_token": "string",    "platform": "Google"  }'
{
  "calendar": {
    "email": "string",
    "google_id": "string",
    "name": "string",
    "resource_id": "string",
    "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
  }
}