Make a booking

curl --request POST \
  --url https://{your-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": "daily",
  "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>"
    }
  ],
  "form_responses_as_hash": {}
}

POST

bookings

Make a booking

curl --request POST \
  --url https://{your-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": "daily",
  "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>"
    }
  ],
  "form_responses_as_hash": {}
}

Replace {your-workspace} with your workspace’s subdomain.
Learn how to find your subdomain in Identifying your subdomain.

Headers

X-Api-Key

string

required

X-Api-Key is used to authenticate requests using an API key. Provide your API key in this header to access protected endpoints. Refer to Authentication for more information.

Body

application/json

meeting_slug

string

required

Slug of scheduling link you want to book.

Example:

"meeting-with-oliver-smith"

name

string

required

Name of person making the booking.

Example:

"Eve Smith"

string

required

Email of person making the booking.

Example:

"eve@example.com"

time_zone

string

required

Time zone of person making the booking.

Example:

"Asia/Kolkata"

slot_date

string

Date on which you want to book. This should be in "YYYY-MM-DD" format. If slot_date and slot_start_time are not provided then the first available slot will be booked.

Example:

"2025-07-15"

slot_start_time

string

Start time for the booking. This should be in "HH:MM AM/PM" format.

Example:

"01:30 PM"

preferred_meeting_spot

enum<string>

default:jitsi

Your preferred meeting spot. This field is optional. Before passing this value, ensure that the corresponding meeting spot is configured in the "Where" section of the scheduling link.

Available options:

custom,

jitsi,

in_person,

daily,

zoom,

whereby,

google_meet,

teams

Example:

"jitsi"

form_responses

object

Responses for the questions of booking form (optional). The key of the field should be the field code of the question. The field code can be found in scheduling link's Settings -> Questions -> 3 dot menu of the question -> Edit -> Advanced properties. You can specify guest emails using the guest_email_s field code.

Hide child attributes

form_responses.guest_email_s

string[]

Array of guest emails for the booking. The default field code is "guest_email_s". You can change this by editing the Guest email(s) question, and changing the field code in advanced properties.

Example:

{
  "guest_email_s": ["sam@example.com", "charlie@example.com"],
  "language": "English"
}

Response

200 - application/json

OK - Request succeeded

string

Unique identifier for the booking.

sid

string

Short identifier (SID) for the booking, used in URLs and API calls.

parent_booking_id

string | null

Reference to the parent booking if this is a group booking.

string

Email address of the person who made the booking.

name

string

Name of the person who made the booking.

host_name

string

Name of the primary host for the meeting.

host_email

string

Email address of the primary host for the meeting.

is_multihost

boolean

Whether the meeting has multiple hosts.

multihosts

object[]

List of all hosts for the meeting when is_multihost is true.

Hide child attributes

name

string

Name of the host.

string

Email address of the host.

starts_at

string<date-time>

Start time of the booking in UTC.

ends_at

string<date-time>

End time of the booking in UTC.

time_zone

string

Time zone of the booking location.

starts_at_for_client

string

Start time of the booking in the client's local time zone.

ends_at_for_client

string

End time of the booking in the client's local time zone.

status

string

Current status of the booking (e.g., confirmed, cancelled, awaiting_approval, rejected).

cancel_reason

string | null

Reason provided when the booking was cancelled.

cancelled_by

string | null

Name of the person who cancelled the booking.

reschedule_requested

boolean

Whether a reschedule has been requested for this booking.

preferred_meeting_spot

string

Preferred meeting platform or location type selected by the client.

room_type

enum<string> | null

Type of meeting room or platform being used.

Available options:

daily,

zoom,

jitsi,

google_meet,

teams,

whereby,

in_person,

custom,

phone_call

room_url

string | null

URL for the meeting room or platform.

room_id

string | null

Unique identifier for the meeting room or platform.

spot_details

string | null

Additional details about the meeting location or platform.

created_at

string<date-time>

Timestamp when the booking was created.

updated_at

string<date-time>

Timestamp when the booking was last updated.

meeting_id

string

Unique identifier of the scheduling link this booking belongs to.

meeting

object

Basic information about the associated meeting.

Hide child attributes

meeting.name

string

Name of the meeting/scheduling link.

no_show

boolean

Whether the booking is marked as no-show by the host.

meeting_outcome

string | null

Outcome status of the meeting.

notes_url

string | null

URL to access notes or additional information about the booking.

internal_notes

string | null

Internal notes about the booking visible only to hosts and admins.

metadata

object | null

Additional custom data associated with the booking.

admin_booking_url

string

URL for hosts and admins to view and manage the booking.

client_booking_url

string

URL for clients to view their booking details.

form_responses

object[]

Responses submitted through the booking form.

Hide child attributes

field

string

Display name of the form field.

value

string

Value submitted for the form field.

type

string

Type of the form field (e.g., name, email, additional_guests).

field_code

string

Internal code identifier for the form field.

form_responses_as_hash

object

Form responses organized as key-value pairs for easier access.

Hide child attributes

form_responses_as_hash.{key}

string

Get booking details Reschedule a booking

Getting Started

Scheduling links API

Meeting spots API

Meeting durations API

Bookings API

Availabilities API

Slots API

Packages API

Team Members API

Discount Codes API

Make a booking

Headers

Body

Response