ActionCal.comUpdated September 2026

How do I create a Cal.com booking via API?

Short answer: You can create booking in Cal.com by hand from its own interface, but it won’t repeat itself. On TinyCommand, add the Cal.com Create Booking action to a workflow, map its 6 inputs from any upstream app, and it runs automatically every time the trigger fires. No code, and a free tier to start.

Create Booking in Cal.com — start free
Inputs

The fields this action accepts.

Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.

FieldTypeRequiredDescription
Event Type ID
eventTypeId
stringRequiredThe event type ID from Cal.com (numeric). Find it in Cal.com → Event Types.
Start Time
start
datetimeRequiredISO 8601 datetime
Attendee Name
attendeeName
stringRequiredAttendee Name
Attendee Email
attendeeEmail
stringRequiredAttendee Email
Timezone
attendeeTimeZone
stringOptionalTimezone. Example: America/New_York
Notes
notes
stringOptionalNotes
Sample request
{
"eventTypeId": "{{trigger.eventTypeId}}",
"start": "{{trigger.start}}",
"attendeeName": "{{trigger.attendeeName}}",
"attendeeEmail": "{{trigger.attendeeEmail}}",
"attendeeTimeZone": "e.g. America/New_York"
}
Returns
{
"data": {
"uid": "abc-123",
"title": "30 Min Meeting",
"status": "accepted",
"startTime": "2026-04-15T14:00:00Z"
},
"status": "success"
}

Use these fields in downstream nodes for routing, logging, or error handling.

Triggered by

Apps that pair well as the trigger for Create Booking.

Any of these apps can fire this action as part of a workflow.

FAQ

Questions about Create Booking.

What does the Create Booking action do in Cal.com?
Books a slot for a specified host event type, time, and booker. Useful for "external scheduling tool → push booking into Cal.com for unified calendar visibility" sync workflows.
What inputs does Create Booking require?
Required: Event Type ID, Start Time, Attendee Name, Attendee Email. Every input accepts a static value or a variable from any upstream node in your workflow.
Can I use dynamic inputs from earlier workflow nodes?
Yes. Any field on this action can pull values from upstream nodes, whether that's a form response, a trigger payload, an AI output, or a lookup result.
What happens if Cal.com returns an error?
The run history shows the failed step with its input and the error message Cal.com returned, so you can fix the input and run the workflow again. Automatic retries are built into HTTP steps only, where you can also set your own retry count and delay.
Does Create Booking support batch operations?
Run Create Booking inside a loop to process each item in an array. TinyCommand does not throttle calls for you, so for large arrays add a Delay step if you need to stay within Cal.com's rate limits.
More actions

Other Cal.com actions.

Create Booking in Cal.com — start free