Meetings

Cancel a meeting

Cancels the booking in the connected calendar tool, which tells the invitee, and marks the meeting canceled. A meeting from a calendar that is no longer connected is only marked canceled in Bavlio.

DELETE
/meetings/{id}

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

idstringrequired

Id of the meeting.

Response

application/json

Success

idstringrequired
statusenum<string>required

confirmed until the meeting ends, then completed; no_show when the invitee did not attend (marked in Bavlio or reported by Calendly or Cal.com); canceled when it was called off.

Available options: confirmed, completed, no_show, canceled

providerenum<string>required

Calendar tool the booking came from.

Available options: google_calendar, calendly, calcom

person_namestringrequired

Name of the invitee from the booking, else the name of the matched lead, else "Unknown invitee".

person_emailstring | nullrequired

Invitee's email address; null when unknown.

leadobject | nullrequired

Campaign lead matched to the invitee by the tracked booking link, email or a unique name; null when none matched.

campaignobject | nullrequired

Campaign of the matched lead; null when no lead matched.

starts_atstringrequired

Start time, as an ISO 8601 timestamp.

ends_atstringrequired

End time, as an ISO 8601 timestamp.

timezonestringrequired

IANA time zone of the booking as the calendar tool reports it, like Europe/Rome; UTC when it reports none.

join_urlstring | nullrequired

Video call link; null when the booking has none.

external_idstringrequired

The booking's id in the calendar tool.

titlestring | nullrequired

The booking's title in the calendar tool; null when it has none.

cancel_reasonstring | nullrequired

Reason given for the cancellation, "Canceled from Bavlio" when canceled through Bavlio; null when none.

created_atstringrequired

When Bavlio first recorded the meeting, as an ISO 8601 timestamp.