Cal.com
App · Calendars · 5 actions
Manage Cal.com bookings from Lodol: create, look up, list, reschedule, and cancel scheduling requests.
Actions
| Action | What it does |
|---|---|
| Cancel booking | Cancel an existing Cal.com booking by its UID. |
| Create booking | Book a slot on one of your Cal.com event types for an attendee. |
| Get booking | Retrieve the details of a single Cal.com booking by its UID. |
| List bookings | List Cal.com bookings, optionally filtered by status, attendee email, or event type. |
| Reschedule booking | Move an existing Cal.com booking to a new start time. |
Cancel booking
Cancel an existing Cal.com booking by its UID.
Inputs
- Booking UID
booking_uidtextRequired - The UID of the booking to cancel.
- Cancellation reason
cancellation_reasontext - An optional reason shown to the attendee.
Outputs
idnumber- Numeric booking ID.
statustext- Booking status after cancellation.
uidtext- Booking UID.
Example output
{
"id": 123,
"status": "cancelled",
"uid": "aBcD1234"
}Create booking
Book a slot on one of your Cal.com event types for an attendee.
Inputs
- Event type
event_type_idtextRequired - The event type to book a slot on.
- Start time
startdate and timeRequired - When the booking should start.
- Attendee name
attendee_nametextRequired - The attendee's full name.
- Attendee email
attendee_emailtextRequired - The attendee's email address.
- Attendee time zone
attendee_timezonetextRequired - The attendee's time zone.One of:
Africa/Abidjan,Africa/Accra,Africa/Addis_Ababa,Africa/Algiers,Africa/Asmara,Africa/Asmera,Africa/Bamako,Africa/Bangui,Africa/Banjul,Africa/Bissau, and 589 more. - Attendee phone number
attendee_phone_numbertext - Optional phone number, required only for phone-based event types.
- Guests
guestslist - Optional list of additional guest email addresses.
- Location
locationtext - Optional meeting location or URL to override the event type default.
Outputs
endtext- End time (ISO 8601).
idnumber- Numeric booking ID.
starttext- Start time (ISO 8601).
statustext- Booking status (accepted, pending, cancelled, ...).
titletext- Booking title.
uidtext- Booking UID used to look it up or change it later.
Example output
{
"end": "2026-08-13T09:30:00.000Z",
"id": 123,
"start": "2026-08-13T09:00:00.000Z",
"status": "accepted",
"title": "30 Min Meeting between Acme and Jordan Lee",
"uid": "aBcD1234"
}Get booking
Retrieve the details of a single Cal.com booking by its UID.
Inputs
- Booking UID
booking_uidtextRequired - The booking's UID. Use 'List bookings' or a 'Create booking' result to find it.
Outputs
endtext- End time (ISO 8601).
idnumber- Numeric booking ID.
starttext- Start time (ISO 8601).
statustext- Booking status.
titletext- Booking title.
uidtext- Booking UID.
Example output
{
"end": "2026-08-13T09:30:00.000Z",
"id": 123,
"start": "2026-08-13T09:00:00.000Z",
"status": "accepted",
"title": "30 Min Meeting between Acme and Jordan Lee",
"uid": "aBcD1234"
}List bookings
List Cal.com bookings, optionally filtered by status, attendee email, or event type.
Inputs
- Status
statustext - Optional status filter: upcoming, recurring, past, cancelled, or unconfirmed.One of:
upcoming,recurring,past,cancelled,unconfirmed. - Attendee email
attendee_emailtext - Optional filter for bookings that include this attendee email.
- Event type
event_type_idtext - Optional filter for bookings of a specific event type.
- Take
takenumber - Maximum number of bookings to return (page size).
Outputs
bookingslist- The bookings that matched the filters.
Example output
{
"bookings": [
{
"end": "2026-08-13T09:30:00.000Z",
"id": 123,
"start": "2026-08-13T09:00:00.000Z",
"status": "accepted",
"title": "30 Min Meeting",
"uid": "aBcD1234"
}
]
}Reschedule booking
Move an existing Cal.com booking to a new start time. This creates a new booking that supersedes the old one.
Inputs
- Booking UID
booking_uidtextRequired - The UID of the booking to reschedule.
- New start time
startdate and timeRequired - The new start time to move the booking to.
- Reschedule reason
rescheduling_reasontext - An optional reason shown to the attendee.
Outputs
idnumber- Numeric booking ID.
starttext- New start time (ISO 8601).
statustext- Booking status.
uidtext- UID of the new (rescheduled) booking.
Example output
{
"id": 124,
"start": "2026-08-14T10:00:00.000Z",
"status": "accepted",
"uid": "eFgH5678"
}