Skip to main content
The Calendar API allows you to integrate with calendar platforms like Google Calendar and Microsoft Outlook. You can create calendar connections, manage OAuth credentials, and sync calendar data.

​
Supported Platforms

The Calendar API supports the following platforms:
  • Google Calendar (google_calendar)
  • Microsoft Outlook (microsoft_outlook)

​
Calendar Status

Calendar connections can have the following statuses:
  • connecting - Initial connection is being established
  • connected - Successfully connected and syncing
  • disconnected - Connection has been terminated or failed

​
Authentication

All calendar integrations use OAuth 2.0 for authentication. You’ll need to provide:
  • OAuth client ID
  • OAuth client secret
  • OAuth refresh token
  • OAuth email (optional)

​
Available Methods

Create Calendar

Connect a new calendar integration

List Calendars

Retrieve all calendar connections

Retrieve Calendar

Get details of a specific calendar

Update Calendar

Update calendar OAuth credentials

Delete Calendar

Remove a calendar connection

​
Quick Start

import { RecallClient } from '@recall-ai/sdk';

const client = new RecallClient({
  apiKey: 'your-api-key'
});

// Create a new calendar connection
const calendar = await client.calendar.create({
  platform: 'google_calendar',
  oauth_client_id: 'your-client-id',
  oauth_client_secret: 'your-client-secret',
  oauth_refresh_token: 'your-refresh-token',
  oauth_email: '[email protected]'
});

// List all calendars
const calendars = await client.calendar.list({
  status: 'connected'
});

Build docs developers (and LLMs) love

Get started for freeTalk to us