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

apiKey
string
query
required

Query Parameters

apiKey
string
required

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.