Bookings
Creates a new booking
Getting Started
Attendees
Availabilities
Booking References
Bookings
Credentials
Destination Calendars
Event Types
Memberships
Schedules
Selected Calendars
Teams
Users
Bookings
Creates a new booking
POST
/
bookings
curl --request POST \
--url https://api.cal.com/v1/bookings \
--header 'Content-Type: application/json' \
--data '{
"eventTypeId": 2323232,
"start": "2023-05-24T13:00:00.000Z",
"end": "2023-05-24T13:30:00.000Z",
"responses": {
"name": "Hello Hello",
"email": "[email protected]",
"smsReminderNumber": null,
"location": {
"value": "userPhone",
"optionValue": ""
}
},
"timeZone": "Europe/London",
"language": "en",
"title": "Debugging between Syed Ali Shahbaz and Hello Hello",
"description": null,
"status": "PENDING",
"metadata": {}
}'
{
"booking": {
"id": 91,
"userId": 5,
"description": "",
"eventTypeId": 7,
"uid": "bFJeNb2uX8ANpT3JL5EfXw",
"title": "60min between Pro Example and John Doe",
"startTime": "2023-05-25T09:30:00.000Z",
"endTime": "2023-05-25T10:30:00.000Z",
"attendees": [
{
"email": "[email protected]",
"name": "John Doe",
"timeZone": "Asia/Kolkata",
"locale": "en"
}
],
"user": {
"email": "[email protected]",
"name": "Pro Example",
"timeZone": "Asia/Kolkata",
"locale": "en"
},
"payment": [
{
"id": 1,
"success": true,
"paymentOption": "ON_BOOKING"
}
],
"metadata": {},
"status": "ACCEPTED",
"responses": {
"email": "[email protected]",
"name": "John Doe",
"location": {
"optionValue": "",
"value": "inPerson"
}
}
}
}
Authorizations
Query Parameters
Your API key
Body
application/json
Create a new booking related to one of your event-types
The body is of type object
.
Response
200
application/json
Booking(s) created successfully.
The response is of type any
.
Was this page helpful?
curl --request POST \
--url https://api.cal.com/v1/bookings \
--header 'Content-Type: application/json' \
--data '{
"eventTypeId": 2323232,
"start": "2023-05-24T13:00:00.000Z",
"end": "2023-05-24T13:30:00.000Z",
"responses": {
"name": "Hello Hello",
"email": "[email protected]",
"smsReminderNumber": null,
"location": {
"value": "userPhone",
"optionValue": ""
}
},
"timeZone": "Europe/London",
"language": "en",
"title": "Debugging between Syed Ali Shahbaz and Hello Hello",
"description": null,
"status": "PENDING",
"metadata": {}
}'
{
"booking": {
"id": 91,
"userId": 5,
"description": "",
"eventTypeId": 7,
"uid": "bFJeNb2uX8ANpT3JL5EfXw",
"title": "60min between Pro Example and John Doe",
"startTime": "2023-05-25T09:30:00.000Z",
"endTime": "2023-05-25T10:30:00.000Z",
"attendees": [
{
"email": "[email protected]",
"name": "John Doe",
"timeZone": "Asia/Kolkata",
"locale": "en"
}
],
"user": {
"email": "[email protected]",
"name": "Pro Example",
"timeZone": "Asia/Kolkata",
"locale": "en"
},
"payment": [
{
"id": 1,
"success": true,
"paymentOption": "ON_BOOKING"
}
],
"metadata": {},
"status": "ACCEPTED",
"responses": {
"email": "[email protected]",
"name": "John Doe",
"location": {
"optionValue": "",
"value": "inPerson"
}
}
}
}