Skip to main content
POST
Cancel a Meeting
When cancelled, Nexor:
  • Cancels the lead’s and host’s pending reminders.
  • Notifies the host and sends the lead a cancellation email.
  • Deletes the external calendar event and frees the availability slot.
  • Logs a meeting_cancelled timeline activity.
  • Fires a meeting.cancelled outbound webhook and, when configured, triggers the re-engage agent.
Meetings owned by an external provider that Nexor doesn’t control (e.g. an inbound-only Calendly invitee) are not cancelled; the response returns "skipped": true. Idempotency: cancelling a meeting that is already cancelled is a safe no-op ("idempotent": true).

Authorizations

X-API-Key
string
header
required

API key for authentication. Keys are prefixed with nxr_live_.

Path Parameters

id
string<uuid>
required

The meeting ID, from the POST /meetings response or GET /leads/{id}/meetings.

Body

application/json
reason
string

Stored as cancellation_reason; included in the lead/host notifications.

Response

Cancelled (or skipped for a provider-owned meeting)

success
boolean
skipped
boolean
meeting
object
Last modified on June 26, 2026