Skip to main content
POST
/
bookings
Creates a new booking
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

apiKey
string
query
required

Query Parameters

apiKey
string
required

Body

application/json
eventTypeId
integer
required
start
string<date-time>
required
responses
object
required
metadata
object
required
timeZone
string
required
language
string
required
end
string<date-time>
rescheduleUid
string<UID>
title
string
recurringEventId
integer
description
string
status
string
seatsPerTimeSlot
integer
seatsShowAttendees
boolean
seatsShowAvailabilityCount
boolean

Response