Skip to main content

Overview

The /schedule endpoint creates a meeting at a specific time you’ve already selected. Use this when you’ve used /availability to find slots and want the user to pick, or when you have a predetermined time. For AI-powered automatic scheduling, use /schedule/auto instead.

Authentication

Requires Platform API Key in the X-API-Key header.

Request

Request Body

array
required
Array of exactly 2 email addresses
string
required
ISO 8601 timestamp for meeting start (e.g., “2025-01-22T14:00:00Z”)
integer
required
Meeting duration in minutes
string
required
Meeting title
string
Meeting description/agenda
string
Defaults to “Google Meet” for video conference

Example Request

Response

Success Response (200 OK)

Error Responses

Same error responses as /schedule/auto.

Usage Limits

Each successful schedule counts toward your monthly meeting limit based on plan:
  • Developer: 25 meetings/month
  • Starter: 250 meetings/month
  • Pro: 1,000 meetings/month
  • Scale: 5,000 meetings/month
  • Enterprise: Unlimited

Example

Find Availability

Find mutual availability first

Auto Schedule

Let AI pick the time