POST
/
bookings
Make a booking
curl --request POST \
  --url https://{workspace}.neetocal.com/api/external/v1/bookings \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <x-api-key>' \
  --data '{
  "meeting_slug": "meeting-with-oliver-smith",
  "name": "Eve Smith",
  "email": "eve@example.com",
  "slot_date": "2025-07-15",
  "slot_start_time": "01:30 PM",
  "time_zone": "Asia/Kolkata",
  "preferred_meeting_spot": "jitsi",
  "form_responses": {
    "guest_email_s": [
      "sam@example.com",
      "charlie@example.com"
    ],
    "language": "English"
  }
}'
{
  "id": "<string>",
  "sid": "<string>",
  "parent_booking_id": "<string>",
  "email": "<string>",
  "name": "<string>",
  "host_name": "<string>",
  "host_email": "<string>",
  "is_multihost": true,
  "multihosts": [
    {
      "name": "<string>",
      "email": "<string>"
    }
  ],
  "starts_at": "2023-11-07T05:31:56Z",
  "ends_at": "2023-11-07T05:31:56Z",
  "time_zone": "<string>",
  "starts_at_for_client": "<string>",
  "ends_at_for_client": "<string>",
  "status": "<string>",
  "cancel_reason": "<string>",
  "cancelled_by": "<string>",
  "reschedule_requested": true,
  "preferred_meeting_spot": "<string>",
  "room_type": "<string>",
  "room_url": "<string>",
  "room_id": "<string>",
  "spot_details": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "meeting_id": "<string>",
  "meeting": {
    "name": "<string>"
  },
  "no_show": true,
  "meeting_outcome": "<string>",
  "notes_url": "<string>",
  "internal_notes": "<string>",
  "metadata": {},
  "admin_booking_url": "<string>",
  "client_booking_url": "<string>",
  "form_responses": [
    {
      "field": "<string>",
      "value": "<string>",
      "type": "<string>",
      "field_code": "<string>"
    }
  ]
}
Replace {your-workspace} with your workspace’s subdomain.
Learn how to find your subdomain in Identifying your subdomain.

Headers

X-Api-Key
string
required

You can generate an API key from the NeetoCal API Keys dashboard.

Body

application/json

Response

200
application/json

OK - Request succeeded

The response is of type object.