API Reference - Meridian

Getting Started

Meridian provides a powerful API built on the Model Context Protocol (MCP) with JSON-RPC 2.0 for AI tool integrations, plus standard REST endpoints for specific operations. The API exposes 58 tools covering event types, bookings, availability, scheduling polls, links, webhooks, and more.

All MCP tool calls are made via a single POST /api/mcp endpoint using JSON-RPC 2.0. You can also browse and download the OpenAPI 3.1 specification for use with code generators and API clients.

Authentication

Meridian supports three authentication methods. Choose the one that best fits your integration.

API Keys (Recommended)

Generate API keys in Dashboard > Settings > API Keys. Keys are prefixed with mk_ and should be sent as a Bearer token in the Authorization header.

cURL example

curl -X POST https://your-domain/api/mcp \
  -H "Authorization: Bearer mk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

OAuth 2.1

For MCP-compatible clients that support OAuth-based authentication. Discovery metadata is available at /.well-known/oauth-protected-resource. The authorization server metadata is auto-discovered per RFC 8414.

Session Cookie

For browser-based access. When authenticated via the Meridian dashboard, API calls from the same browser session are automatically authenticated using the session cookie.

Base URL

Production

https://i60-meridian-production.up.railway.app

All API endpoints are relative to this base URL. For local development, use http://localhost:3000.

MCP Protocol

Meridian implements the Model Context Protocol (MCP) over HTTP using JSON-RPC 2.0. All tool interactions go through a single endpoint: POST /api/mcp

Supported Methods

Method	Description
initialize	Handshake with the server. Returns protocol version and server capabilities.
notifications/initialized	Notification sent after successful initialization.
tools/list	List all available tools with schemas and annotations.
tools/call	Execute a tool by name with the provided arguments.
ping	Health check. Returns a pong response.

Request Format

tools/call request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_event_types",
    "arguments": {
      "status": "active"
    }
  },
  "id": 1
}

Response Envelope

All tool responses are wrapped in a profiled envelope that includes success status, the data payload, and contextual metadata.

tools/call response

{
  "jsonrpc": "2.0",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"success\":true,\"status\":\"completed\",\"data\":[\"...\"],\"context\":{\"warnings\":[],\"itemsProcessed\":3,\"suggestedNextActions\":[\"get_event_type\",\"create_event_type\"]}}"
      }
    ]
  },
  "id": 1
}

REST Endpoints

In addition to the MCP protocol, Meridian provides the following REST endpoints for specific operations.

GET/api/mcp

Server discovery information. Returns protocol version, server name, and capabilities. Used by MCP clients during initial discovery.

Auth: None

GET/api/booking/{uid}/ics

Download an ICS calendar file for a specific booking. The {uid} parameter is the unique booking identifier.

Auth: None (public link)

GET/api/booking-cover

Read the signed-in host's default cover or an owned event type override with ?eventTypeId=UUID.

Auth: Browser session

POST/api/booking-cover

Upload a JPEG, PNG, or WebP cover under 5 MB as multipart/form-data; eventTypeId is optional.

Auth: Same-origin browser session

DELETE/api/booking-cover

Remove the host default or an event type override selected with ?eventTypeId=UUID.

Auth: Same-origin browser session

GET/api/booking-cover/{id}

Download a public, processed WebP cover by its opaque UUID.

Auth: None (public image)

POST/api/cron/reminders

Trigger processing of pending booking reminders. Sends reminder emails for upcoming bookings based on configured reminder windows.

Auth: CRON_SECRET header

GET/api/openapi

Download the OpenAPI 3.1 specification for the Meridian API. Useful for code generation and API client libraries.

Auth: None

Tool Reference

Meridian exposes 58 tools through the MCP protocol, organized into the categories below. Each tool can be called via the tools/call JSON-RPC method.

Event Types9 tools

list_event_types

List Event TypesreadOnly

List all event types for the current user. Returns title, slug, duration, location type, active status, and booking link.

Parameters

Name	Type	Required	Description
status	`string` activeinactiveall	No	Filter by active status (default: all)

statusstring

Filter by active status (default: all)

activeinactiveall

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_event_types",
    "arguments": {
      "status": "active"
    }
  },
  "id": 1
}

get_event_type

Get Event TypereadOnly

Get full details of a specific event type by ID, including custom questions and scheduling rules.

Parameters

Name	Type	Required	Description
id	`string`	Yes	Event type UUID

idstringrequired

Event type UUID

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_event_type",
    "arguments": {
      "id": "<id>"
    }
  },
  "id": 1
}

create_event_type

Create Event Typedestructive

Create a new event type. Requires title, slug, and duration. Returns the created event type.

Parameters

Name	Type	Required	Description
title	`string`	Yes	Event type title
slug	`string`	Yes	URL-friendly slug (lowercase, hyphens only, e.g. 'quick-chat')
description	`string`	No	Optional description of the event
duration	`integer`	Yes	Duration in minutes (5-480, default 30)
color	`string`	No	Hex color code (default #6366f1)
locationType	`string` google_meetmicrosoft_teamsin_personphonecustom	No	Meeting location type (default google_meet)
locationValue	`string`	No	Provide an address, phone number, or meeting URL for in_person, phone, or custom locations
scheduleId	`string`	No	Owned availability schedule UUID from list_availability_schedules. Omit to use the default schedule.
bufferBefore	`integer`	No	Buffer minutes before event (0-120, default 0)
bufferAfter	`integer`	No	Buffer minutes after event (0-120, default 0)
minNotice	`integer`	No	Minimum notice in minutes before booking (default 240 = 4 hours)
maxDaysAhead	`integer`	No	Max days into the future for booking (default 60)
requiresConfirmation	`boolean`	No	Require host confirmation for bookings (default false)
slotInterval	`integer`	No	Slot interval in minutes (>= 1). If omitted, uses duration.
dailyLimit	`integer`	No	Max bookings per day for this event type
weeklyLimit	`integer`	No	Max bookings per week for this event type
allowReschedule	`boolean`	No	Allow invitees to reschedule (default true)
allowCancellation	`boolean`	No	Allow invitees to cancel (default true)
reminderEnabled	`boolean`	No	Enable email reminders (default true)
reminderHoursBefore	`number[]`	No	Hours before meeting to send reminders (default [24, 1])
recurringEnabled	`boolean`	No	Allow recurring bookings (default false)
recurringConfig	`object`	No	Recurring event configuration
maxInvitees	`integer`	No	Max invitees per slot. 1=1:1, >1=group, 0=unlimited (default 1)
schedulingType	`string` individualround_robincollective	No	Scheduling type (default individual); round_robin and collective require Team plan and event type members
isSecret	`boolean`	No	Hide from public booking page (only accessible via direct link)
durationOptions	`number[]`	No	Additional duration options invitees can choose from (e.g. [15, 30, 60])
monthlyLimit	`integer`	No	Max bookings per month for this event type
maxDaysAheadMode	`string` rollingrangeindefinite	No	Booking window: rolling days (default), fixed end date (range), or indefinite
maxDaysAheadEnd	`string`	No	Fixed end date for booking window (YYYY-MM-DD); used when maxDaysAheadMode is 'range'
roundRobinMode	`string` priorityequal	No	Round-robin assignment mode: 'priority' assigns by member priority order; 'equal' assigns the least-booked member

titlestringrequired

Event type title

slugstringrequired

URL-friendly slug (lowercase, hyphens only, e.g. 'quick-chat')

descriptionstring

Optional description of the event

durationintegerrequired

Duration in minutes (5-480, default 30)

colorstring

Hex color code (default #6366f1)

locationTypestring

Meeting location type (default google_meet)

google_meetmicrosoft_teamsin_personphonecustom

locationValuestring

Provide an address, phone number, or meeting URL for in_person, phone, or custom locations

scheduleIdstring

Owned availability schedule UUID from list_availability_schedules. Omit to use the default schedule.

bufferBeforeinteger

Buffer minutes before event (0-120, default 0)

bufferAfterinteger

Buffer minutes after event (0-120, default 0)

minNoticeinteger

Minimum notice in minutes before booking (default 240 = 4 hours)

maxDaysAheadinteger

Max days into the future for booking (default 60)

requiresConfirmationboolean

Require host confirmation for bookings (default false)

slotIntervalinteger

Slot interval in minutes (>= 1). If omitted, uses duration.

dailyLimitinteger

Max bookings per day for this event type

weeklyLimitinteger

Max bookings per week for this event type

allowRescheduleboolean

Allow invitees to reschedule (default true)

allowCancellationboolean

Allow invitees to cancel (default true)

reminderEnabledboolean

Enable email reminders (default true)

reminderHoursBeforenumber[]

Hours before meeting to send reminders (default [24, 1])

recurringEnabledboolean

Allow recurring bookings (default false)

recurringConfigobject

Recurring event configuration

maxInviteesinteger

Max invitees per slot. 1=1:1, >1=group, 0=unlimited (default 1)

schedulingTypestring

Scheduling type (default individual); round_robin and collective require Team plan and event type members

individualround_robincollective

isSecretboolean

Hide from public booking page (only accessible via direct link)

durationOptionsnumber[]

Additional duration options invitees can choose from (e.g. [15, 30, 60])

monthlyLimitinteger

Max bookings per month for this event type

maxDaysAheadModestring

Booking window: rolling days (default), fixed end date (range), or indefinite

rollingrangeindefinite

maxDaysAheadEndstring

Fixed end date for booking window (YYYY-MM-DD); used when maxDaysAheadMode is 'range'

roundRobinModestring

Round-robin assignment mode: 'priority' assigns by member priority order; 'equal' assigns the least-booked member

priorityequal

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "create_event_type",
    "arguments": {
      "title": "<title>",
      "slug": "<slug>"
    }
  },
  "id": 1
}

update_event_type

Update Event Typedestructiveidempotent

Update fields on an existing event type. Only provided fields are changed.

Parameters

Name	Type	Required	Description
id	`string`	Yes	Event type UUID to update
title	`string`	No	New title
description	`string`	No	New description
duration	`integer`	No	New duration in minutes
color	`string`	No	New hex color
locationType	`string` google_meetmicrosoft_teamsin_personphonecustom	No	--
locationValue	`string`	No	--
scheduleId	`stringnull`	No	Owned availability schedule UUID; use list_availability_schedules to find one, or null to use the default schedule
bufferBefore	`integer`	No	--
bufferAfter	`integer`	No	--
minNotice	`integer`	No	--
maxDaysAhead	`integer`	No	--
requiresConfirmation	`boolean`	No	--
allowReschedule	`boolean`	No	--
allowCancellation	`boolean`	No	--
slotInterval	`integer`	No	Slot interval in minutes (>= 1)
dailyLimit	`integer`	No	Max bookings per day
weeklyLimit	`integer`	No	Max bookings per week
reminderEnabled	`boolean`	No	Enable email reminders
reminderHoursBefore	`number[]`	No	Hours before to send reminders
recurringEnabled	`boolean`	No	Allow recurring bookings
recurringConfig	`object`	No	--
maxInvitees	`integer`	No	Max invitees per slot
schedulingType	`string` individualround_robincollective	No	Round-robin and collective require Team plan and event type members
isSecret	`boolean`	No	Hide from public booking page
durationOptions	`number[]`	No	Additional duration options for invitees
monthlyLimit	`integer`	No	Max bookings per month
maxDaysAheadMode	`string` rollingrangeindefinite	No	Booking window cutoff mode
maxDaysAheadEnd	`string`	No	Fixed end date for booking window (YYYY-MM-DD)
roundRobinMode	`string` priorityequal	No	Round-robin assignment mode: 'priority' assigns by member priority order; 'equal' assigns the least-booked member

idstringrequired

Event type UUID to update

titlestring

New title

descriptionstring

New description

durationinteger

New duration in minutes

colorstring

New hex color

locationTypestring

google_meetmicrosoft_teamsin_personphonecustom

locationValuestring

scheduleIdstringnull

Owned availability schedule UUID; use list_availability_schedules to find one, or null to use the default schedule

bufferBeforeinteger

bufferAfterinteger

minNoticeinteger

maxDaysAheadinteger

requiresConfirmationboolean

allowRescheduleboolean

allowCancellationboolean

slotIntervalinteger

Slot interval in minutes (>= 1)

dailyLimitinteger

Max bookings per day

weeklyLimitinteger

Max bookings per week

reminderEnabledboolean

Enable email reminders

reminderHoursBeforenumber[]

Hours before to send reminders

recurringEnabledboolean

Allow recurring bookings

recurringConfigobject

maxInviteesinteger

Max invitees per slot

schedulingTypestring

Round-robin and collective require Team plan and event type members

individualround_robincollective

isSecretboolean

Hide from public booking page

durationOptionsnumber[]

Additional duration options for invitees

monthlyLimitinteger

Max bookings per month

maxDaysAheadModestring

Booking window cutoff mode

rollingrangeindefinite

maxDaysAheadEndstring

Fixed end date for booking window (YYYY-MM-DD)

roundRobinModestring

Round-robin assignment mode: 'priority' assigns by member priority order; 'equal' assigns the least-booked member

priorityequal

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "update_event_type",
    "arguments": {
      "id": "<id>",
      "title": "<title>"
    }
  },
  "id": 1
}

toggle_event_type

Toggle Event Typedestructiveidempotent

Enable or disable an event type. Disabled types cannot be booked.

Parameters

Name	Type	Required	Description
id	`string`	Yes	Event type UUID
isActive	`boolean`	Yes	true to enable, false to disable

idstringrequired

Event type UUID

isActivebooleanrequired

true to enable, false to disable

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "toggle_event_type",
    "arguments": {
      "id": "<id>",
      "isActive": true
    }
  },
  "id": 1
}

delete_event_type

Delete Event Typedestructive

Permanently delete an event type. This cannot be undone. Existing bookings are preserved.

Parameters

Name	Type	Required	Description
id	`string`	Yes	Event type UUID to delete

idstringrequired

Event type UUID to delete

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "delete_event_type",
    "arguments": {
      "id": "<id>"
    }
  },
  "id": 1
}

add_event_type_member

Add Event Type Memberdestructive

Add a team member to an event type for round-robin or collective scheduling.

Parameters

Name	Type	Required	Description
eventTypeId	`string`	Yes	Event type UUID
userId	`string`	Yes	User ID of the team member to add

eventTypeIdstringrequired

Event type UUID

userIdstringrequired

User ID of the team member to add

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "add_event_type_member",
    "arguments": {
      "eventTypeId": "<eventTypeId>",
      "userId": "<userId>"
    }
  },
  "id": 1
}

remove_event_type_member

Remove Event Type Memberdestructive

Remove a team member from an event type.

Parameters

Name	Type	Required	Description
eventTypeId	`string`	Yes	Event type UUID
userId	`string`	Yes	User ID of the member to remove

eventTypeIdstringrequired

Event type UUID

userIdstringrequired

User ID of the member to remove

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "remove_event_type_member",
    "arguments": {
      "eventTypeId": "<eventTypeId>",
      "userId": "<userId>"
    }
  },
  "id": 1
}

list_event_type_members

List Event Type MembersreadOnly

List all team members assigned to an event type.

Parameters

Name	Type	Required	Description
eventTypeId	`string`	Yes	Event type UUID

eventTypeIdstringrequired

Event type UUID

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_event_type_members",
    "arguments": {
      "eventTypeId": "<eventTypeId>"
    }
  },
  "id": 1
}

Bookings7 tools

list_bookings

List BookingsreadOnly

List bookings for the current user. Can filter by status and time period.

Parameters

Name	Type	Required	Description
status	`string` confirmedpendingcancelledall	No	Filter by booking status (default: confirmed)
timeframe	`string` upcomingpastall	No	Filter by time period relative to now (default: upcoming)
limit	`integer`	No	Max results to return (default: 50)
startDate	`string`	No	Filter bookings on or after this date (YYYY-MM-DD)
endDate	`string`	No	Filter bookings on or before this date (YYYY-MM-DD, inclusive)

statusstring

Filter by booking status (default: confirmed)

confirmedpendingcancelledall

timeframestring

Filter by time period relative to now (default: upcoming)

upcomingpastall

limitinteger

Max results to return (default: 50)

startDatestring

Filter bookings on or after this date (YYYY-MM-DD)

endDatestring

Filter bookings on or before this date (YYYY-MM-DD, inclusive)

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_bookings",
    "arguments": {
      "status": "confirmed",
      "timeframe": "upcoming"
    }
  },
  "id": 1
}

get_booking

Get BookingreadOnly

Get full details of a specific booking by UID, including invitee info, responses, and meeting link.

Parameters

Name	Type	Required	Description
uid	`string`	Yes	Booking UID (the short public-facing ID)

uidstringrequired

Booking UID (the short public-facing ID)

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_booking",
    "arguments": {
      "uid": "<uid>"
    }
  },
  "id": 1
}

cancel_booking

Cancel BookingdestructiveopenWorld

Cancel a confirmed booking as the host. Optionally provide a cancellation reason.

Parameters

Name	Type	Required	Description
uid	`string`	Yes	Booking UID to cancel
reason	`string`	No	Optional cancellation reason

uidstringrequired

Booking UID to cancel

reasonstring

Optional cancellation reason

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "cancel_booking",
    "arguments": {
      "uid": "<uid>",
      "reason": "<reason>"
    }
  },
  "id": 1
}

confirm_booking

Confirm BookingopenWorld

Confirm a pending booking as the host. Only bookings with status 'pending' (confirmation-required event types) can be confirmed.

Parameters

Name	Type	Required	Description
uid	`string`	Yes	Booking UID to confirm

uidstringrequired

Booking UID to confirm

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "confirm_booking",
    "arguments": {
      "uid": "<uid>"
    }
  },
  "id": 1
}

reschedule_booking

Reschedule BookingdestructiveidempotentopenWorld

Reschedule an existing confirmed booking to a new time. Updates the calendar event, notifies the invitee, and sends updated ICS. Use get_available_slots first to find valid new times.

Parameters

Name	Type	Required	Description
uid	`string`	Yes	Booking UID to reschedule
newStartTime	`string`	Yes	New start time in ISO 8601 UTC (e.g. '2026-04-16T14:00:00Z')

uidstringrequired

Booking UID to reschedule

newStartTimestringrequired

New start time in ISO 8601 UTC (e.g. '2026-04-16T14:00:00Z')

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "reschedule_booking",
    "arguments": {
      "uid": "<uid>",
      "newStartTime": "<newStartTime>"
    }
  },
  "id": 1
}

list_booking_video_providers

List Booking Video ProvidersreadOnly

List Google Meet or Microsoft Teams options that can be attached to a specific upcoming confirmed booking. Existing calendar events can only use their original provider.

Parameters

Name	Type	Required	Description
bookingUid	`string`	Yes	Booking UID

bookingUidstringrequired

Booking UID

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_booking_video_providers",
    "arguments": {
      "bookingUid": "<bookingUid>"
    }
  },
  "id": 1
}

attach_booking_video

Attach Video to BookingopenWorld

Add Google Meet or Microsoft Teams to an existing upcoming confirmed booking with no meeting URL. Updates the original provider event or creates one if needed, stores the join URL on the booking, and asks the calendar provider to notify attendees. Call only after the host explicitly authorizes the invitation update.

Parameters

Name	Type	Required	Description
bookingUid	`string`	Yes	Booking UID
provider	`string` google_meetmicrosoft_teams	Yes	Provider returned by list_booking_video_providers
confirmInvitation	`boolean`	Yes	Set true only after the host authorizes updating the calendar invitation

bookingUidstringrequired

Booking UID

providerstringrequired

Provider returned by list_booking_video_providers

google_meetmicrosoft_teams

confirmInvitationbooleanrequired

Set true only after the host authorizes updating the calendar invitation

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "attach_booking_video",
    "arguments": {
      "bookingUid": "<bookingUid>",
      "provider": "google_meet"
    }
  },
  "id": 1
}

Booking Covers3 tools

get_booking_cover

Get Booking CoverreadOnly

Get the host's default booking cover or an owned event type's effective cover. An event override takes precedence over the host default. Returns public WebP image URLs, not image bytes.

Parameters

Name	Type	Required	Description
eventTypeId	`string`	No	Owned event type UUID; omit for the host default cover

eventTypeIdstring

Owned event type UUID; omit for the host default cover

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_booking_cover",
    "arguments": {
      "eventTypeId": "<eventTypeId>"
    }
  },
  "id": 1
}

set_booking_cover

Set Booking CoveropenWorld

Upload or replace the host's default booking cover, or an owned event type override. Supply raw base64 JPEG, PNG, or WebP bytes (no data URI), under 5 MB. Meridian centre-crops to 1600 x 640 and stores WebP. The image is publicly viewable on the booking page.

Parameters

Name	Type	Required	Description
eventTypeId	`string`	No	Owned event type UUID; omit for the host default cover
imageBase64	`string`	Yes	Raw base64 encoded JPEG, PNG, or WebP image, under 5 MB decoded

eventTypeIdstring

Owned event type UUID; omit for the host default cover

imageBase64stringrequired

Raw base64 encoded JPEG, PNG, or WebP image, under 5 MB decoded

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "set_booking_cover",
    "arguments": {
      "eventTypeId": "<eventTypeId>",
      "imageBase64": "<imageBase64>"
    }
  },
  "id": 1
}

remove_booking_cover

Remove Booking Coverdestructiveidempotent

Remove the host's default booking cover or an owned event type override. Removing an event override restores the host default when one exists.

Parameters

Name	Type	Required	Description
eventTypeId	`string`	No	Owned event type UUID; omit to remove the host default cover

eventTypeIdstring

Owned event type UUID; omit to remove the host default cover

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "remove_booking_cover",
    "arguments": {
      "eventTypeId": "<eventTypeId>"
    }
  },
  "id": 1
}

Availability & Calendar7 tools

get_available_slots

Get Available SlotsreadOnly

Get available time slots for a specific event type on a given date. The date is a civil day in the event's availability schedule timezone. Each result has time (ISO 8601 UTC start) and display (formatted in the requested timezone); there is no end field. Pass slot.time to offer_times. For create_poll, calculate endTime by adding the event duration to slot.time.

Parameters

Name	Type	Required	Description
eventTypeId	`string`	Yes	Event type UUID to check
date	`string`	Yes	Date YYYY-MM-DD in the event availability schedule's timezone, not the viewer timezone.
timezone	`string`	No	IANA timezone (e.g. 'Africa/Johannesburg', 'America/New_York'). Formats the display label only; time remains UTC. Defaults to UTC. Use the event schedule's timezone to show host-local times.
duration	`integer`	No	Override event type duration in minutes. Useful when the event type offers multiple duration options.

eventTypeIdstringrequired

Event type UUID to check

datestringrequired

Date YYYY-MM-DD in the event availability schedule's timezone, not the viewer timezone.

timezonestring

IANA timezone (e.g. 'Africa/Johannesburg', 'America/New_York'). Formats the display label only; time remains UTC. Defaults to UTC. Use the event schedule's timezone to show host-local times.

durationinteger

Override event type duration in minutes. Useful when the event type offers multiple duration options.

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_available_slots",
    "arguments": {
      "eventTypeId": "<eventTypeId>",
      "date": "<date>"
    }
  },
  "id": 1
}

list_availability_schedules

List Availability SchedulesreadOnly

List the current user's availability schedules with IDs, timezones, and default status. Use an ID with get_availability_schedule or an event type's scheduleId.

Parameters

No parameters required.

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_availability_schedules",
    "arguments": {}
  },
  "id": 1
}

create_availability_schedule

Create Availability Scheduledestructive

Create a separate availability schedule with Monday-Friday 09:00-17:00 local-time rules. Review or change its rules with update_availability, then pass its ID as scheduleId when creating or updating an event type.

Parameters

Name	Type	Required	Description
name	`string`	Yes	Name of the new schedule
timezone	`string`	Yes	IANA timezone for schedule hours, such as Africa/Johannesburg

namestringrequired

Name of the new schedule

timezonestringrequired

IANA timezone for schedule hours, such as Africa/Johannesburg

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "create_availability_schedule",
    "arguments": {
      "name": "<name>",
      "timezone": "<timezone>"
    }
  },
  "id": 1
}

get_availability_schedule

Get Availability SchedulereadOnly

Get the user's availability schedule with all rules (days and time windows).

Parameters

Name	Type	Required	Description
scheduleId	`string`	No	Specific schedule UUID. If omitted, returns the default schedule.

scheduleIdstring

Specific schedule UUID. If omitted, returns the default schedule.

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_availability_schedule",
    "arguments": {
      "scheduleId": "<scheduleId>"
    }
  },
  "id": 1
}

update_availability

Update Availabilitydestructiveidempotent

Update availability rules for a schedule. Replaces all rules for the specified days.

Parameters

Name	Type	Required	Description
scheduleId	`string`	Yes	Schedule UUID to update
days	`object`	Yes	Map of day-of-week (0=Sun..6=Sat) to availability. Each value: { "enabled": boolean, "windows": [{ "start": "HH:MM", "end": "HH:MM" }] }

scheduleIdstringrequired

Schedule UUID to update

daysobjectrequired

Map of day-of-week (0=Sun..6=Sat) to availability. Each value: { "enabled": boolean, "windows": [{ "start": "HH:MM", "end": "HH:MM" }] }

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "update_availability",
    "arguments": {
      "scheduleId": "<scheduleId>"
    }
  },
  "id": 1
}

add_availability_override

Add Availability Overridedestructiveidempotent

Block off a specific date or set custom hours for a date. Omit start/end times to block the entire day.

Parameters

Name	Type	Required	Description
date	`string`	Yes	Date to override (YYYY-MM-DD)
startTime	`string`	No	Custom start time (HH:MM). Omit to block the entire day.
endTime	`string`	No	Custom end time (HH:MM). Omit to block the entire day.
scheduleId	`string`	No	Schedule UUID. If omitted, uses the default schedule.

datestringrequired

Date to override (YYYY-MM-DD)

startTimestring

Custom start time (HH:MM). Omit to block the entire day.

endTimestring

Custom end time (HH:MM). Omit to block the entire day.

scheduleIdstring

Schedule UUID. If omitted, uses the default schedule.

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "add_availability_override",
    "arguments": {
      "date": "<date>",
      "startTime": "<startTime>"
    }
  },
  "id": 1
}

list_connected_calendars

List Connected CalendarsreadOnly

List Google and Microsoft calendars connected to the user's account, showing which are used for conflict checking and booking creation.

Parameters

No parameters required.

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_connected_calendars",
    "arguments": {}
  },
  "id": 1
}

Scheduling Polls8 tools

create_poll

Create Scheduling PolldestructiveopenWorld

Create ONE scheduling poll with multiple proposed time slots across one or more days. Invitees vote yes/no on each slot; the best slot wins and becomes a booking. IMPORTANT: Always create a SINGLE poll containing ALL proposed time slots — do NOT create separate polls per day. For example, to find a meeting time across Mon–Thu with 3 options each day, create one poll with 12 slots. All times must be ISO 8601 in UTC (e.g. '2026-04-15T14:00:00Z'). Use get_availability_schedule to learn the event schedule's timezone, then get_available_slots to find open slots — those return UTC times you can pass directly to this tool. Returns a public voting URL to share with invitees (no login required).

Parameters

Name	Type	Required	Description
title	`string`	Yes	Poll title (e.g. 'Team Sync — Week of Apr 14')
description	`string`	No	Optional description shown on the voting page
duration	`integer`	No	Meeting duration in minutes (default 30)
locationType	`string` google_meetmicrosoft_teamsin_personphonecustom	No	Meeting location type (default google_meet)
locationValue	`string`	No	Location details (address, phone, URL) — required for in_person, phone, custom
eventTypeId	`string`	No	Event type UUID. Links the poll to an event type so a real booking is created when the poll resolves. If omitted here, must be provided in resolve_poll.
slots	`object[]`	Yes	All proposed time options for the poll. Include slots across multiple days in a single array. Each slot is one voting option. Example for 2 days × 2 slots: [{startTime:'2026-04-15T09:00:00Z',endTime:'2026-04-15T09:30:00Z'},{startTime:'2026-04-15T14:00:00Z',endTime:'2026-04-15T14:30:00Z'},{startTime:'2026-04-16T09:00:00Z',endTime:'2026-04-16T09:30:00Z'},{startTime:'2026-04-16T14:00:00Z',endTime:'2026-04-16T14:30:00Z'}]
inviteeEmails	`string[]`	No	Email addresses of expected voters. When ALL have voted and autoResolve is true, the poll auto-resolves and creates a booking. Also used for send_poll_invites.
autoResolve	`boolean`	No	Automatically book the best slot when all invitees have voted (default true)
deadline	`string`	No	Optional voting deadline as ISO 8601 UTC timestamp

titlestringrequired

Poll title (e.g. 'Team Sync — Week of Apr 14')

descriptionstring

Optional description shown on the voting page

durationinteger

Meeting duration in minutes (default 30)

locationTypestring

Meeting location type (default google_meet)

google_meetmicrosoft_teamsin_personphonecustom

locationValuestring

Location details (address, phone, URL) — required for in_person, phone, custom

eventTypeIdstring

Event type UUID. Links the poll to an event type so a real booking is created when the poll resolves. If omitted here, must be provided in resolve_poll.

slotsobject[]required

All proposed time options for the poll. Include slots across multiple days in a single array. Each slot is one voting option. Example for 2 days × 2 slots: [{startTime:'2026-04-15T09:00:00Z',endTime:'2026-04-15T09:30:00Z'},{startTime:'2026-04-15T14:00:00Z',endTime:'2026-04-15T14:30:00Z'},{startTime:'2026-04-16T09:00:00Z',endTime:'2026-04-16T09:30:00Z'},{startTime:'2026-04-16T14:00:00Z',endTime:'2026-04-16T14:30:00Z'}]

inviteeEmailsstring[]

Email addresses of expected voters. When ALL have voted and autoResolve is true, the poll auto-resolves and creates a booking. Also used for send_poll_invites.

autoResolveboolean

Automatically book the best slot when all invitees have voted (default true)

deadlinestring

Optional voting deadline as ISO 8601 UTC timestamp

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "create_poll",
    "arguments": {
      "title": "<title>",
      "description": "<description>"
    }
  },
  "id": 1
}

update_poll

Update Polldestructiveidempotent

Update an open scheduling poll's details or time slots. Only open polls can be edited. Slots with votes cannot be removed.

Parameters

Name	Type	Required	Description
pollId	`string`	Yes	Poll UUID or UID to update
title	`string`	No	New poll title
description	`string`	No	New description (or null to clear)
locationType	`string` google_meetmicrosoft_teamsin_personphonecustom	No	New meeting location type
locationValue	`string`	No	New location details
deadline	`string`	No	New voting deadline (ISO 8601) or null to remove
autoResolve	`boolean`	No	Enable/disable auto-resolve when all invitees vote
eventTypeId	`string`	No	Event type UUID for booking creation at resolve time
inviteeEmails	`string[]`	No	Replace expected voter emails. Existing voters are preserved.
addSlots	`object[]`	No	New time slots to add to the poll
removeSlotIds	`string[]`	No	Slot UUIDs to remove. Fails if any slot has votes.

pollIdstringrequired

Poll UUID or UID to update

titlestring

New poll title

descriptionstring

New description (or null to clear)

locationTypestring

New meeting location type

google_meetmicrosoft_teamsin_personphonecustom

locationValuestring

New location details

deadlinestring

New voting deadline (ISO 8601) or null to remove

autoResolveboolean

Enable/disable auto-resolve when all invitees vote

eventTypeIdstring

Event type UUID for booking creation at resolve time

inviteeEmailsstring[]

Replace expected voter emails. Existing voters are preserved.

addSlotsobject[]

New time slots to add to the poll

removeSlotIdsstring[]

Slot UUIDs to remove. Fails if any slot has votes.

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "update_poll",
    "arguments": {
      "pollId": "<pollId>",
      "title": "<title>"
    }
  },
  "id": 1
}

list_polls

List PollsreadOnly

List scheduling polls for the current user. Can filter by status.

Parameters

Name	Type	Required	Description
status	`string` openclosedbookedall	No	Filter by poll status (default: all)

statusstring

Filter by poll status (default: all)

openclosedbookedall

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_polls",
    "arguments": {
      "status": "open"
    }
  },
  "id": 1
}

get_poll_results

Get Poll ResultsreadOnly

Get vote tallies per slot, who has/hasn't voted, and the best matching slot for a scheduling poll.

Parameters

Name	Type	Required	Description
pollId	`string`	Yes	Poll UUID or UID

pollIdstringrequired

Poll UUID or UID

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_poll_results",
    "arguments": {
      "pollId": "<pollId>"
    }
  },
  "id": 1
}

resolve_poll

Resolve PolldestructiveopenWorld

Resolve a scheduling poll by selecting a winning slot. Creates a real booking for that slot and discards the rest.

Parameters

Name	Type	Required	Description
pollId	`string`	Yes	Poll UUID or UID
slotId	`string`	No	Winning slot UUID. If omitted, auto-picks the best match.
eventTypeId	`string`	No	Event type UUID for the booking. Required if not set on the poll.

pollIdstringrequired

Poll UUID or UID

slotIdstring

Winning slot UUID. If omitted, auto-picks the best match.

eventTypeIdstring

Event type UUID for the booking. Required if not set on the poll.

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "resolve_poll",
    "arguments": {
      "pollId": "<pollId>",
      "slotId": "<slotId>"
    }
  },
  "id": 1
}

close_poll

Close Polldestructiveidempotent

Close an open poll to stop voting. Does not create a booking. Use resolve_poll to pick a winner first if needed.

Parameters

Name	Type	Required	Description
pollId	`string`	Yes	Poll UUID or UID to close

pollIdstringrequired

Poll UUID or UID to close

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "close_poll",
    "arguments": {
      "pollId": "<pollId>"
    }
  },
  "id": 1
}

delete_poll

Delete Polldestructive

Permanently delete a scheduling poll and all its votes. This cannot be undone.

Parameters

Name	Type	Required	Description
pollId	`string`	Yes	Poll UUID or UID to delete

pollIdstringrequired

Poll UUID or UID to delete

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "delete_poll",
    "arguments": {
      "pollId": "<pollId>"
    }
  },
  "id": 1
}

send_poll_invites

Send Poll InvitesopenWorld

Send (or re-send) invitation or reminder emails for a scheduling poll. Requires inviteeEmails to be set on the poll. Use mode 'invite' for first-time invitations, 'reminder' for follow-ups to people who haven't voted yet.

Parameters

Name	Type	Required	Description
pollId	`string`	Yes	Poll UUID or UID
mode	`string` invitereminder	Yes	Email type: 'invite' sends to all invitees, 'reminder' sends only to those who haven't voted yet

pollIdstringrequired

Poll UUID or UID

modestringrequired

Email type: 'invite' sends to all invitees, 'reminder' sends only to those who haven't voted yet

invitereminder

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "send_poll_invites",
    "arguments": {
      "pollId": "<pollId>",
      "mode": "invite"
    }
  },
  "id": 1
}

Scheduling Links6 tools

create_scheduling_link

Create Scheduling LinkdestructiveopenWorld

Create a Pro scheduling link (single-use or offer-times) and return its shareable booking URL. Email and calendar holds are off by default. Offer-times needs 1-50 distinct, available future slots whose duration matches the event type or its duration options.

Parameters

Name	Type	Required	Description
eventTypeId	`string`	Yes	Event type UUID for this link
type	`string` single_useoffer_times	Yes	Link type: single_use (one booking) or offer_times (invitee picks from offered slots)
inviteeName	`string`	No	Name of the invitee
inviteeEmail	`string`	No	Email of the invitee (required if sendEmail is true)
offeredSlots	`object[]`	No	For offer_times: 1-50 distinct available future slots, each with ISO UTC start and end; duration must match the event type or an allowed duration option
allowOutsideAvailability	`boolean`	No	Unsupported; must be false. Offered times must be within availability.
reserveHolds	`boolean`	No	Attempt tentative holds on a connected writable calendar (default false; check list_connected_calendars first)
singleUse	`boolean`	No	Link can only be used once (default true for single_use type)
expiresIn	`string` 24h48h7d30d	No	Link expiry duration; omit for a link without an expiry
sendEmail	`boolean`	No	Send invitation email to invitee (default false; requires inviteeEmail and configured email provider)
message	`string`	No	Optional message included in the invitation email

eventTypeIdstringrequired

Event type UUID for this link

typestringrequired

Link type: single_use (one booking) or offer_times (invitee picks from offered slots)

single_useoffer_times

inviteeNamestring

Name of the invitee

inviteeEmailstring

Email of the invitee (required if sendEmail is true)

offeredSlotsobject[]

For offer_times: 1-50 distinct available future slots, each with ISO UTC start and end; duration must match the event type or an allowed duration option

allowOutsideAvailabilityboolean

Unsupported; must be false. Offered times must be within availability.

reserveHoldsboolean

Attempt tentative holds on a connected writable calendar (default false; check list_connected_calendars first)

singleUseboolean

Link can only be used once (default true for single_use type)

expiresInstring

Link expiry duration; omit for a link without an expiry

24h48h7d30d

sendEmailboolean

Send invitation email to invitee (default false; requires inviteeEmail and configured email provider)

messagestring

Optional message included in the invitation email

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "create_scheduling_link",
    "arguments": {
      "eventTypeId": "<eventTypeId>",
      "type": "single_use"
    }
  },
  "id": 1
}

list_scheduling_links

List Scheduling LinksreadOnly

List scheduling links for the current user. Can filter by status and event type.

Parameters

Name	Type	Required	Description
status	`string` allactiveusedexpiredcancelled	No	Filter by link status (default: all)
eventTypeId	`string`	No	Filter by event type UUID

statusstring

Filter by link status (default: all)

allactiveusedexpiredcancelled

eventTypeIdstring

Filter by event type UUID

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_scheduling_links",
    "arguments": {
      "status": "all",
      "eventTypeId": "<eventTypeId>"
    }
  },
  "id": 1
}

get_scheduling_link

Get Scheduling LinkreadOnly

Get full details of a scheduling link by ID or token, including calendar holds.

Parameters

Name	Type	Required	Description
linkId	`string`	No	Scheduling link UUID
token	`string`	No	Scheduling link token

linkIdstring

Scheduling link UUID

tokenstring

Scheduling link token

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_scheduling_link",
    "arguments": {
      "linkId": "<linkId>",
      "token": "<token>"
    }
  },
  "id": 1
}

cancel_scheduling_link

Cancel Scheduling Linkdestructive

Cancel an active scheduling link. Releases any calendar holds.

Parameters

Name	Type	Required	Description
linkId	`string`	Yes	Scheduling link UUID to cancel

linkIdstringrequired

Scheduling link UUID to cancel

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "cancel_scheduling_link",
    "arguments": {
      "linkId": "<linkId>"
    }
  },
  "id": 1
}

delete_scheduling_link

Delete Scheduling Linkdestructive

Permanently delete a non-active scheduling link. Active links must be cancelled first.

Parameters

Name	Type	Required	Description
linkId	`string`	Yes	Scheduling link UUID to delete

linkIdstringrequired

Scheduling link UUID to delete

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "delete_scheduling_link",
    "arguments": {
      "linkId": "<linkId>"
    }
  },
  "id": 1
}

offer_times

Offer TimesdestructiveopenWorld

Create a Pro offer-times link from 1-50 distinct, available future UTC start times. Calculates end times from the event duration or an allowed duration option. Email and tentative calendar holds default to true; set sendEmail/reserveHolds false when sharing manually or without a writable calendar.

Parameters

Name	Type	Required	Description
eventTypeId	`string`	Yes	Event type UUID
inviteeEmail	`string`	Yes	Email of the invitee
inviteeName	`string`	No	Name of the invitee
slots	`string[]`	Yes	1-50 distinct ISO 8601 UTC start times from get_available_slots result slot.time, all in the future.
duration	`integer`	No	Meeting duration in minutes. If omitted, uses the event type's default duration.
reserveHolds	`boolean`	No	Attempt tentative holds on a connected writable calendar (default true; set false when no such calendar is connected)
sendEmail	`boolean`	No	Send invitation email (default true; requires configured email provider). Set false to share the URL yourself.
expiresIn	`string` 24h48h7d30d	No	Link expiry duration (default '48h')
message	`string`	No	Optional message included in the invitation email

eventTypeIdstringrequired

Event type UUID

inviteeEmailstringrequired

Email of the invitee

inviteeNamestring

Name of the invitee

slotsstring[]required

1-50 distinct ISO 8601 UTC start times from get_available_slots result slot.time, all in the future.

durationinteger

Meeting duration in minutes. If omitted, uses the event type's default duration.

reserveHoldsboolean

Attempt tentative holds on a connected writable calendar (default true; set false when no such calendar is connected)

sendEmailboolean

Send invitation email (default true; requires configured email provider). Set false to share the URL yourself.

expiresInstring

Link expiry duration (default '48h')

24h48h7d30d

messagestring

Optional message included in the invitation email

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "offer_times",
    "arguments": {
      "eventTypeId": "<eventTypeId>",
      "inviteeEmail": "<inviteeEmail>"
    }
  },
  "id": 1
}

Routing Forms4 tools

create_routing_form

Create Routing Formdestructive

Create a routing form to qualify leads and direct them to the right event type.

Parameters

Name	Type	Required	Description
title	`string`	Yes	Form title
slug	`string`	Yes	URL slug (lowercase, hyphens)
description	`string`	No	Optional form description
fields	`object[]`	Yes	Form fields
rules	`object[]`	Yes	Routing rules (first match wins)

titlestringrequired

Form title

slugstringrequired

URL slug (lowercase, hyphens)

descriptionstring

Optional form description

fieldsobject[]required

Form fields

rulesobject[]required

Routing rules (first match wins)

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "create_routing_form",
    "arguments": {
      "title": "<title>",
      "slug": "<slug>"
    }
  },
  "id": 1
}

update_routing_form

Update Routing Formdestructiveidempotent

Update an existing routing form's fields, rules, or settings.

Parameters

Name	Type	Required	Description
id	`string`	Yes	Routing form UUID
title	`string`	No	--
slug	`string`	No	--
description	`string`	No	--
fields	`object[]`	No	--
rules	`object[]`	No	--
isActive	`boolean`	No	--

idstringrequired

Routing form UUID

titlestring

slugstring

descriptionstring

fieldsobject[]

rulesobject[]

isActiveboolean

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "update_routing_form",
    "arguments": {
      "id": "<id>",
      "title": "<title>"
    }
  },
  "id": 1
}

list_routing_forms

List Routing FormsreadOnly

List all routing forms for the current user.

Parameters

No parameters required.

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_routing_forms",
    "arguments": {}
  },
  "id": 1
}

delete_routing_form

Delete Routing Formdestructive

Permanently delete a routing form.

Parameters

Name	Type	Required	Description
id	`string`	Yes	Routing form UUID to delete

idstringrequired

Routing form UUID to delete

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "delete_routing_form",
    "arguments": {
      "id": "<id>"
    }
  },
  "id": 1
}

Workflows5 tools

list_workflows

List WorkflowsreadOnly

List automated email workflows configured for the current user. Workflows send emails to invitees or hosts when booking events occur (created, cancelled, rescheduled) or at a fixed offset before/after the meeting.

Parameters

No parameters required.

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_workflows",
    "arguments": {}
  },
  "id": 1
}

create_workflow

Create Workflowdestructive

Create an automated email workflow. Fires on booking events or at a scheduled offset relative to the meeting. Triggers: 'booking.created', 'booking.cancelled', 'booking.rescheduled' fire immediately; 'before_event' and 'after_event' require triggerMinutes (e.g. 60 = 1 hour). Actions send email to the invitee or host with template variables: {{invitee_name}}, {{event_name}}, {{event_date_time}}, {{location}}, {{meeting_url}}, {{host_name}}, {{cancel_link}}, {{reschedule_link}}. Requires a Pro plan. Scope to specific event types with eventTypeIds, or pass [] for all.

Parameters

Name	Type	Required	Description
name	`string`	Yes	Workflow name (e.g. '24h reminder')
trigger	`string` booking.createdbooking.cancelledbooking.rescheduledbefore_eventafter_event	Yes	When this workflow fires
triggerMinutes	`integer`	No	Minutes offset for 'before_event' / 'after_event' triggers. Ignored for event-based triggers.
actions	`object[]`	Yes	One or more email actions to run when the trigger fires
eventTypeIds	`string[]`	Yes	Event type UUIDs this workflow applies to. Pass [] to apply to all event types.

namestringrequired

Workflow name (e.g. '24h reminder')

triggerstringrequired

When this workflow fires

booking.createdbooking.cancelledbooking.rescheduledbefore_eventafter_event

triggerMinutesinteger

Minutes offset for 'before_event' / 'after_event' triggers. Ignored for event-based triggers.

actionsobject[]required

One or more email actions to run when the trigger fires

eventTypeIdsstring[]required

Event type UUIDs this workflow applies to. Pass [] to apply to all event types.

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "create_workflow",
    "arguments": {
      "name": "<name>",
      "trigger": "booking.created"
    }
  },
  "id": 1
}

update_workflow

Update Workflowdestructiveidempotent

Update an existing workflow's name, trigger, actions, or event-type scope. Pass isActive to enable or disable without changing other fields.

Parameters

Name	Type	Required	Description
id	`string`	Yes	Workflow UUID to update
name	`string`	No	--
trigger	`string` booking.createdbooking.cancelledbooking.rescheduledbefore_eventafter_event	No	--
triggerMinutes	`integer`	No	--
actions	`object[]`	No	--
eventTypeIds	`string[]`	No	--
isActive	`boolean`	No	--

idstringrequired

Workflow UUID to update

namestring

triggerstring

booking.createdbooking.cancelledbooking.rescheduledbefore_eventafter_event

triggerMinutesinteger

actionsobject[]

eventTypeIdsstring[]

isActiveboolean

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "update_workflow",
    "arguments": {
      "id": "<id>",
      "name": "<name>"
    }
  },
  "id": 1
}

toggle_workflow

Toggle Workflowdestructive

Flip a workflow's active status. An inactive workflow does not fire on its triggers.

Parameters

Name	Type	Required	Description
id	`string`	Yes	Workflow UUID

idstringrequired

Workflow UUID

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "toggle_workflow",
    "arguments": {
      "id": "<id>"
    }
  },
  "id": 1
}

delete_workflow

Delete Workflowdestructive

Permanently delete a workflow. Scheduled executions that haven't yet fired are cascade-deleted. This cannot be undone.

Parameters

Name	Type	Required	Description
id	`string`	Yes	Workflow UUID

idstringrequired

Workflow UUID

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "delete_workflow",
    "arguments": {
      "id": "<id>"
    }
  },
  "id": 1
}

Webhooks4 tools

register_webhook

Parameters

Name	Type	Required	Description
url	`string`	Yes	Endpoint URL to receive webhook POSTs
events	`string[]`	Yes	Events to subscribe to

urlstringrequired

Endpoint URL to receive webhook POSTs

eventsstring[]required

Events to subscribe to

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "register_webhook",
    "arguments": {
      "url": "<url>"
    }
  },
  "id": 1
}

list_webhooks

List WebhooksreadOnly

List all registered webhooks for the current user.

Parameters

No parameters required.

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_webhooks",
    "arguments": {}
  },
  "id": 1
}

delete_webhook

Delete Webhookdestructive

Delete a registered webhook.

Parameters

Name	Type	Required	Description
id	`string`	Yes	Webhook UUID to delete

idstringrequired

Webhook UUID to delete

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "delete_webhook",
    "arguments": {
      "id": "<id>"
    }
  },
  "id": 1
}

test_webhook

Test WebhookdestructiveopenWorld

Send a test delivery to a registered webhook.

Parameters

Name	Type	Required	Description
id	`string`	Yes	Webhook UUID to test

idstringrequired

Webhook UUID to test

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "test_webhook",
    "arguments": {
      "id": "<id>"
    }
  },
  "id": 1
}

Meetings & Video2 tools

list_video_providers

List Video ProvidersreadOnly

List video providers offered by the calendars selected under Add bookings to (Google → Google Meet, Microsoft → Teams). Actual account permissions and video support are checked when creating the event. Use this before create_meeting_link.

Parameters

No parameters required.

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_video_providers",
    "arguments": {}
  },
  "id": 1
}

create_meeting_link

Create Meeting LinkopenWorld

Create a real calendar event and video meeting link in the calendar selected under Add bookings to. Pass provider='auto' (default) to use that calendar's video provider. Supplying attendeeEmail requests a calendar invitation; obtain authorization to invite that person. If eventCreated is returned without a link, the event already exists: do not repeat creation. Check the existing calendar event instead. This does not update an existing Meridian booking.

Parameters

Name	Type	Required	Description
title	`string`	Yes	Meeting title that will appear in the calendar event
startTime	`string`	Yes	ISO 8601 start time, e.g. 2026-04-15T14:00:00Z
endTime	`string`	Yes	ISO 8601 end time, e.g. 2026-04-15T14:30:00Z
description	`string`	No	Optional meeting description / agenda
attendeeEmail	`string`	No	Optional invitee email address — if provided, they get a calendar invite
provider	`string` autogoogle_meetmicrosoft_teams	No	Video provider to use. 'auto' (default) uses a calendar selected under Add bookings to. If both providers have selected booking calendars, Google Meet wins.

titlestringrequired

Meeting title that will appear in the calendar event

startTimestringrequired

ISO 8601 start time, e.g. 2026-04-15T14:00:00Z

endTimestringrequired

ISO 8601 end time, e.g. 2026-04-15T14:30:00Z

descriptionstring

Optional meeting description / agenda

attendeeEmailstring

Optional invitee email address — if provided, they get a calendar invite

providerstring

Video provider to use. 'auto' (default) uses a calendar selected under Add bookings to. If both providers have selected booking calendars, Google Meet wins.

autogoogle_meetmicrosoft_teams

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "create_meeting_link",
    "arguments": {
      "title": "<title>",
      "startTime": "<startTime>"
    }
  },
  "id": 1
}

Profile & Diagnostics3 tools

get_user_profile

Get User ProfilereadOnly

Get the current user's profile including name, email, username, and timezone.

Parameters

No parameters required.

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_user_profile",
    "arguments": {}
  },
  "id": 1
}

update_profile

Update Profiledestructiveidempotent

Update the current user's profile (name, username, timezone, bio, branding).

Parameters

Name	Type	Required	Description
name	`string`	No	Display name
username	`string`	No	Unique username for booking page URL (lowercase, no spaces)
timezone	`string`	No	IANA timezone (e.g. 'America/New_York')
bio	`string`	No	Short bio displayed on booking page
brandColor	`string`	No	Hex color for booking page branding (e.g. '#6366f1')
brandLogoUrl	`string`	No	Logo URL for booking page branding
hideBranding	`boolean`	No	Hide 'Powered by Meridian' footer on booking pages

namestring

Display name

usernamestring

Unique username for booking page URL (lowercase, no spaces)

timezonestring

IANA timezone (e.g. 'America/New_York')

biostring

Short bio displayed on booking page

brandColorstring

Hex color for booking page branding (e.g. '#6366f1')

brandLogoUrlstring

Logo URL for booking page branding

hideBrandingboolean

Hide 'Powered by Meridian' footer on booking pages

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "update_profile",
    "arguments": {
      "name": "<name>",
      "username": "<username>"
    }
  },
  "id": 1
}

search_email_log

Search Email LogreadOnly

Search the email audit log to see what emails the system has sent. Filter by recipient email, trigger type, or date range. Useful for debugging delivery issues or answering 'did we email X?'

Parameters

Name	Type	Required	Description
to	`string`	No	Recipient email address to search for (exact or partial match)
trigger	`string`	No	Filter by trigger type (e.g. 'booking.confirmed', 'poll.invite', 'reminder.24h')
status	`string` sentfailedall	No	Filter by delivery status (default: all)
limit	`integer`	No	Max results to return (default 25, max 100)

tostring

Recipient email address to search for (exact or partial match)

triggerstring

Filter by trigger type (e.g. 'booking.confirmed', 'poll.invite', 'reminder.24h')

statusstring

Filter by delivery status (default: all)

sentfailedall

limitinteger

Max results to return (default 25, max 100)

Example request

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "search_email_log",
    "arguments": {
      "to": "<to>",
      "trigger": "<trigger>"
    }
  },
  "id": 1
}

Error Codes

The API uses standard JSON-RPC 2.0 error codes. When an error occurs, the response will contain an error object instead of a result.

Code	Name	Description
-32700	Parse error	Invalid JSON was received by the server.
-32600	Invalid request	The JSON sent is not a valid JSON-RPC request.
-32601	Method not found	The method does not exist or is not available.
-32602	Invalid params	Invalid method parameter(s). Check required fields and types.
-32001	Authentication error	Missing or invalid authentication credentials.
-32603	Internal error	Internal JSON-RPC error. An unexpected server-side issue.

Error response example

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32001,
    "message": "Authentication required"
  },
  "id": 1
}

Rate Limiting

Limits are applied per client IP on a rolling one-minute window. Exceeding a limit returns 429 Too Many Requests with a Retry-After header (seconds until the window reopens).

Endpoint	Limit	Window
/api/mcp	60 req	1 min
/api/auth/* (POST)	5 req	1 min
createBooking (public)	10 req	1 min

429 responses include headers: X-RateLimit-Limit, X-RateLimit-Remaining, and Retry-After. Build exponential backoff into your client for robustness.

58 tools across 11 categories

Meridian API Reference

Getting Started

Authentication

API Keys (Recommended)

OAuth 2.1

Session Cookie

Base URL

MCP Protocol

Supported Methods

Request Format

Response Envelope

REST Endpoints

Tool Reference

Event Types9 tools

list_event_types

Parameters

get_event_type

Parameters

create_event_type

Parameters

update_event_type

Parameters

toggle_event_type

Parameters

delete_event_type

Parameters

add_event_type_member

Parameters

remove_event_type_member

Parameters

list_event_type_members

Parameters

Bookings7 tools

list_bookings

Parameters

get_booking

Parameters

cancel_booking

Parameters

confirm_booking

Parameters

reschedule_booking

Parameters

list_booking_video_providers

Parameters

attach_booking_video

Parameters

Booking Covers3 tools

get_booking_cover

Parameters

set_booking_cover

Parameters

remove_booking_cover

Parameters

Availability & Calendar7 tools

get_available_slots

Parameters

list_availability_schedules

Parameters

create_availability_schedule

Parameters

get_availability_schedule

Parameters

update_availability

Parameters

add_availability_override

Parameters

list_connected_calendars

Parameters

Scheduling Polls8 tools

create_poll

Parameters

update_poll

Parameters

list_polls

Parameters

get_poll_results

Parameters

resolve_poll

Parameters