/leads/{id}/meetings
Returns all meetings (calendar events) for a lead, sorted by most recent first. Use this to display upcoming appointments, past meeting history, and no-show records in your CRM.
Authenticate every request with the X-API-Key header. See Authentication.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string (uuid) | Yes | Lead ID |
Query Parameters
| Parameter | Type | Description |
|---|---|---|
status | string | Comma-separated status filter: scheduled, confirmed, completed, cancelled, no_show |
Responses
200 Meetings retrieved successfully
Response Fields
| Field | Type | Description |
|---|---|---|
id | string (uuid) | Meeting identifier |
title | string | Meeting title |
starts_at | string (date-time) | Start time (UTC) |
ends_at | string (date-time) | End time (UTC) |
duration_minutes | integer | Duration in minutes |
timezone | string | Timezone used when booking |
status | string | scheduled, confirmed, completed, cancelled, or no_show |
meeting_url | string | null | Video call URL (Google Meet, Zoom, etc.) |
location_type | string | video, phone, or in_person |
location_details | string | null | Additional location info |
host_name | string | null | Assigned host/agent name |
meeting_type | string | null | Meeting type name (for example, “Google Meet”, “Initial Consultation”) |
attendee_name | string | Lead’s name as registered |
attendee_email | string | Lead’s email as registered |
confirmed_by_lead | boolean | Whether the lead confirmed attendance |
cancelled_at | string | null | When the meeting was cancelled |
cancellation_reason | string | null | Why it was cancelled |
no_show_reason | string | null | Reason for no-show (if applicable) |
outcome_notes | string | null | Post-meeting notes |
created_at | string (date-time) | When the meeting was created |