Meetings

Delete a meeting room. Its join link stops working at once for everyone who has it — including invitees holding it in a booking confirmation — and it leaves the Meetings list. The history is kept: every past meeting's attendance, transcript, chat, recap and recording stays on the contacts' timelines and in the account. A member can delete only rooms they host or created; owners and admins can delete any room. Requires the Video Meetings app.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/meetings.delete \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "meeting_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool meetings_delete at https://app.chirply.io/api/mcp, same bearer token, same input.

Fetch one meeting room — its settings, schedule, join link and live status — with its ten most recent meetings (when people were in it, how many came, and whether a recap or recording exists). Read-only. Requires the Video Meetings app.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/meetings.get \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "meeting_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool meetings_get at https://app.chirply.io/api/mcp, same bearer token, same input.

Read the account's default room settings — what every new meeting room starts with: waiting room and its video, lower thirds, timer, branding, guest permissions and live captions. Each room can then change its own. Read-only. Requires the Video Meetings app.

Parameters

No parameters — POST an empty body.

Example

curl -X POST https://app.chirply.io/api/v1/actions/meetings.get_defaults \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{}'

Over MCP the same operation is the tool meetings_get_defaults at https://app.chirply.io/api/mcp, same bearer token, same input.

Fetch everything recorded about one meeting: who attended (name, email, matched contact, host or guest, minutes in the room), the live-caption transcript, the chat, the AI recap if one has been written, and the recording link if the host recorded it. Read-only. Requires the Video Meetings app.

Also answers to meeting transcript, who attended the meeting.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/meetings.get_session \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "session_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool meetings_get_session at https://app.chirply.io/api/mcp, same bearer token, same input.

List the account's meeting rooms with their join links — live rooms first, then the most recently changed. Filter to upcoming rooms (scheduled from six hours ago onward, plus rooms with no set time) or to rooms with people in them right now, and search by title. Read-only. Requires the Video Meetings app.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/meetings.list \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "filter": "all",
    "search": "example"
  }'

Over MCP the same operation is the tool meetings_list at https://app.chirply.io/api/mcp, same bearer token, same input.

List past and in-progress meetings, newest first — each one a single time people were in a room: when it started and ended, the peak number of people, how many distinct attendees came, and whether a recap or recording exists. Give a room's id for that room's history, or omit it for recent meetings across every room. Read-only. Requires the Video Meetings app.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/meetings.list_sessions \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "meeting_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "limit": 20
  }'

Over MCP the same operation is the tool meetings_list_sessions at https://app.chirply.io/api/mcp, same bearer token, same input.

Return a team member's permanent personal meeting room and its link, creating it the first time it is asked for — the same link every time, for that person's recurring calls. Anyone holding the link can ask to join from a web browser — no download and no account; with the waiting room on (the default) a host admits each guest, while members of this account go straight in. Creating it messages nobody. An API key names the member with user_id. Requires the Video Meetings app.

Also answers to my meeting link, personal meeting room.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/meetings.personal_room \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool meetings_personal_room at https://app.chirply.io/api/mcp, same bearer token, same input.

Change the account's default room settings — the starting point for every meeting room created from now on, including personal rooms and booking-page rooms. Rooms that already exist keep their own settings. Omitted fields are left alone; nobody is notified. Owners and admins only. Requires the Video Meetings app.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/meetings.save_defaults \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "waiting_room": true,
    "waiting_video_url": "https://example.com"
  }'

Over MCP the same operation is the tool meetings_save_defaults at https://app.chirply.io/api/mcp, same bearer token, same input.

Create a video meeting room for a set time and return its join link — the Schedule meeting form. Give a start and either an end or a length; link a contact to show the meeting on their record. Anyone holding the link can ask to join from a web browser — no download and no account; with the waiting room on (the default) a host admits each guest, while members of this account go straight in. Scheduling messages nobody and adds nothing to any calendar — send the link in an invite or message yourself. (Appointments booked through a booking page get their rooms automatically.) Requires the Video Meetings app.

Also answers to schedule a video call, set up a zoom, book a video meeting.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/meetings.schedule \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Example",
    "start_at": "2026-09-17T15:00:00Z"
  }'

Over MCP the same operation is the tool meetings_schedule at https://app.chirply.io/api/mcp, same bearer token, same input.

Create an instant video meeting room and return its join link — the Start meeting button. Open the link to go in as the host; the room runs in the browser on the account's own domain, with no time limit. Anyone holding the link can ask to join from a web browser — no download and no account; with the waiting room on (the default) a host admits each guest, while members of this account go straight in. Creating a room messages nobody — share the link yourself. Requires the Video Meetings app.

Also answers to start a video call, new meeting link, instant meeting, zoom meeting.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/meetings.start \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Example",
    "host_user_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool meetings_start at https://app.chirply.io/api/mcp, same bearer token, same input.

Write the AI recap of one meeting from its transcript and chat — an overview, the decisions, action items with their owners when named, and follow-ups — and save it on the meeting, replacing any earlier recap. Each call is one AI completion billed to the account's own AI connection (OpenRouter key). Refused when the meeting has no transcript or chat, or when the account has no AI connection. Requires the Video Meetings app.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Also answers to meeting notes, meeting minutes, meeting summary.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/meetings.summarize_session \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "session_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool meetings_summarize_session at https://app.chirply.io/api/mcp, same bearer token, same input.

Change a meeting room's title, schedule, host, contact or any room setting — waiting room and its video, lower thirds, timer, branding, guest permissions, live captions. Omitted fields are left alone; the join link never changes. Settings apply the next time someone joins, and nobody is notified. A member can change only rooms they host or created; owners and admins can change any room. Requires the Video Meetings app.

Parameters

Example

curl -X POST https://app.chirply.io/api/v1/actions/meetings.update \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "meeting_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Over MCP the same operation is the tool meetings_update at https://app.chirply.io/api/mcp, same bearer token, same input.