Appointment V4

Cancel an appointment

Cancels an appointment as the host or admin. For group bookings, specify attendeeId to remove a single attendee, or set cancelAll: true to cancel the entire appointment — omitting both returns a 400 error to prevent accidental full cancellation.

Side effects: Sends cancellation emails to all participants, syncs calendar events, updates CRM integrations, and fires booking_cancelled webhook.

Series cancellation: Set cancelEntireSeries: true to cancel all future occurrences of a recurring appointment.

post/v4/appointment/{id}/cancel

Request

  • Base URL: https://developer.meetergo.com (the document declares no server; this is the origin it was published from)
  • URL: https://developer.meetergo.com/v4/appointment/{id}/cancel
  • Auth: one of:
    • API key in header x-meetergo-api-user-id
    • HTTP bearer
    • HTTP bearer

Path parameters

idstring required

Appointment ID (UUID)

Request body

reasonstring

Reason for cancellation. Included in notification emails sent to participants.

attendeeIdstring uuid

For group bookings: the ID of the attendee to remove. The appointment continues for remaining attendees. If omitted on a group booking, cancelAll must be set to true.

cancelAllboolean

Required for group bookings when attendeeId is not provided. Confirms intent to cancel the entire group appointment for all attendees. Ignored for non-group bookings.

cancelEntireSeriesboolean

If true and the appointment is part of a recurring series, cancels all future occurrences in addition to this one. Defaults to false.

Example request

{
  "reason": "Schedule conflict"
}

Response

The cancelled appointment

idstring required

Appointment ID

secretstring required

Secret key for appointment authentication

icsstring required

ICS calendar data

startstring required

Appointment start time (ISO string)

endstring required

Appointment end time (ISO string)

isCancelledboolean required

Whether the appointment is cancelled

rescheduledAtstring

When the appointment was rescheduled

rescheduledBystring nullable

Email address of the attendee, host, or operator who last rescheduled the appointment

locationstring

Meeting location

attendeeIdsstring[] required

Array of attendee IDs

meetingTypeIdstring required

Meeting type ID

hostIdsstring[] required

Array of host user IDs

scheduledReminderIdsstring[] required

Array of scheduled reminder IDs

companyIdstring required

Company ID this appointment belongs to

createdAtstring required

Creation timestamp

updatedAtstring required

Last update timestamp

deletedAtstring

Soft deletion timestamp

paymentIdstring

Payment ID if this is a paid appointment

notestring

Appointment note

transcriptionstring nullable

Full meeting transcription in markdown format

summarystring nullable

AI-generated summary of the meeting in markdown format

Changes

No recorded changes to this operation across all 1 revision of this API.