Update a booking

curl --request PATCH \
  --url https://{your-subdomain}.neetocal.com/api/external/v2/bookings/{booking_id} \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <x-api-key>' \
  --data '
{
  "name": "Eve Smith",
  "email": "eve@example.com",
  "slot_date": "2025-07-25",
  "slot_start_time": "10:30 AM",
  "time_zone": "Asia/Kolkata",
  "override_availability": false,
  "reschedule_reason": "I want to change the booking time",
  "cancel_reason": "I am not available",
  "rejection_reason": "Time slot no longer available",
  "meeting_outcome_id": "59413def-60eb-47c6-b390-098fcf583b66"
}
'

const options = {
  method: 'PATCH',
  headers: {'X-Api-Key': '<x-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'Eve Smith',
    email: 'eve@example.com',
    slot_date: '2025-07-25',
    slot_start_time: '10:30 AM',
    time_zone: 'Asia/Kolkata',
    override_availability: false,
    reschedule_reason: 'I want to change the booking time',
    cancel_reason: 'I am not available',
    rejection_reason: 'Time slot no longer available',
    meeting_outcome_id: '59413def-60eb-47c6-b390-098fcf583b66'
  })
};

fetch('https://{your-subdomain}.neetocal.com/api/external/v2/bookings/{booking_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://{your-subdomain}.neetocal.com/api/external/v2/bookings/{booking_id}"

payload = {
    "name": "Eve Smith",
    "email": "eve@example.com",
    "slot_date": "2025-07-25",
    "slot_start_time": "10:30 AM",
    "time_zone": "Asia/Kolkata",
    "override_availability": False,
    "reschedule_reason": "I want to change the booking time",
    "cancel_reason": "I am not available",
    "rejection_reason": "Time slot no longer available",
    "meeting_outcome_id": "59413def-60eb-47c6-b390-098fcf583b66"
}
headers = {
    "X-Api-Key": "<x-api-key>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

{
  "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,
  "is_overridden": true,
  "bypassed_rules": [
    "<string>"
  ],
  "meeting_outcome": {
    "id": "59413def-60eb-47c6-b390-098fcf583b66",
    "name": "Pricing Discussion",
    "color": "yellow",
    "kind": "custom",
    "color_hex": "#EAB308",
    "is_system": false,
    "is_organization_owned": true
  },
  "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": {},
  "add_on_services": [
    {
      "id": "0d3c1e8a-58b7-4c1f-a7f3-3c2f5d1b9e10",
      "add_on_service_id": "77150ec6-d4f0-4665-98f0-34bda69f7b3a",
      "name": "Sauna",
      "duration": 30,
      "amount": "25.5",
      "currency": "USD",
      "free": false
    }
  ],
  "payment": {
    "id": "f46c9ddf-221d-4238-afb2-280c1c6b3185",
    "external_id": "pi_3ThCkv2c3CtEndqE1BwejQno",
    "provider": "stripe",
    "amount": "100.0",
    "currency": "USD",
    "status": "successful",
    "successful": true,
    "payment_at": "2026-06-11T17:51:09.321Z"
  }
}

PATCH

bookings

{booking_id}

Update a booking

curl --request PATCH \
  --url https://{your-subdomain}.neetocal.com/api/external/v2/bookings/{booking_id} \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <x-api-key>' \
  --data '
{
  "name": "Eve Smith",
  "email": "eve@example.com",
  "slot_date": "2025-07-25",
  "slot_start_time": "10:30 AM",
  "time_zone": "Asia/Kolkata",
  "override_availability": false,
  "reschedule_reason": "I want to change the booking time",
  "cancel_reason": "I am not available",
  "rejection_reason": "Time slot no longer available",
  "meeting_outcome_id": "59413def-60eb-47c6-b390-098fcf583b66"
}
'

const options = {
  method: 'PATCH',
  headers: {'X-Api-Key': '<x-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'Eve Smith',
    email: 'eve@example.com',
    slot_date: '2025-07-25',
    slot_start_time: '10:30 AM',
    time_zone: 'Asia/Kolkata',
    override_availability: false,
    reschedule_reason: 'I want to change the booking time',
    cancel_reason: 'I am not available',
    rejection_reason: 'Time slot no longer available',
    meeting_outcome_id: '59413def-60eb-47c6-b390-098fcf583b66'
  })
};

fetch('https://{your-subdomain}.neetocal.com/api/external/v2/bookings/{booking_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://{your-subdomain}.neetocal.com/api/external/v2/bookings/{booking_id}"

payload = {
    "name": "Eve Smith",
    "email": "eve@example.com",
    "slot_date": "2025-07-25",
    "slot_start_time": "10:30 AM",
    "time_zone": "Asia/Kolkata",
    "override_availability": False,
    "reschedule_reason": "I want to change the booking time",
    "cancel_reason": "I am not available",
    "rejection_reason": "Time slot no longer available",
    "meeting_outcome_id": "59413def-60eb-47c6-b390-098fcf583b66"
}
headers = {
    "X-Api-Key": "<x-api-key>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

{
  "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,
  "is_overridden": true,
  "bypassed_rules": [
    "<string>"
  ],
  "meeting_outcome": {
    "id": "59413def-60eb-47c6-b390-098fcf583b66",
    "name": "Pricing Discussion",
    "color": "yellow",
    "kind": "custom",
    "color_hex": "#EAB308",
    "is_system": false,
    "is_organization_owned": true
  },
  "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": {},
  "add_on_services": [
    {
      "id": "0d3c1e8a-58b7-4c1f-a7f3-3c2f5d1b9e10",
      "add_on_service_id": "77150ec6-d4f0-4665-98f0-34bda69f7b3a",
      "name": "Sauna",
      "duration": 30,
      "amount": "25.5",
      "currency": "USD",
      "free": false
    }
  ],
  "payment": {
    "id": "f46c9ddf-221d-4238-afb2-280c1c6b3185",
    "external_id": "pi_3ThCkv2c3CtEndqE1BwejQno",
    "provider": "stripe",
    "amount": "100.0",
    "currency": "USD",
    "status": "successful",
    "successful": true,
    "payment_at": "2026-06-11T17:51:09.321Z"
  }
}

In API v2, this endpoint handles approve, reject, cancel, and reschedule flows. Older v1-only routes for those actions are not available in v2—use status for approve/reject/cancel, and slot_date, slot_start_time, and time_zone to reschedule. See the operation description below for details.

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

Headers

X-Api-Key

string

required

Use the X-Api-Key header to provide your workspace API key. Refer to Authentication for more information.

Path Parameters

booking_id

string

required

ID or SID of the booking that you want to update.

Example:

"hda6gxy"

Body

application/json

name

string

Name of person making the booking. This is applied only as part of a reschedule, so send it alongside slot_date and slot_start_time. A request carrying it without them is rejected with a 422 error.

Example:

"Eve Smith"

string

Email of person making the booking. This is applied only as part of a reschedule, so send it alongside slot_date and slot_start_time. A request carrying it without them is rejected with a 422 error.

Example:

"eve@example.com"

slot_date

string

Date on which the booking is to be rescheduled. This should be in "YYYY-MM-DD" format.

Example:

"2025-07-25"

slot_start_time

string

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

Example:

"10:30 AM"

time_zone

string

Time zone of person rescheduling the booking.

Example:

"Asia/Kolkata"

override_availability

boolean

default:false

When true, reschedules to the requested time even if it is outside the scheduling link's availability, following the same rules as override_availability on Create a booking. Used only when rescheduling. The response includes is_overridden and bypassed_rules.

reschedule_reason

string

Reason for rescheduling the booking (optional).

Example:

"I want to change the booking time"

status

enum<string>

Sets booking lifecycle status in one call (replaces v1 approve / reject / cancel endpoints). Use approved to approve, rejected to reject (optional rejection_reason), or cancelled to cancel (optional cancel_reason). Do not send this field when you are only rescheduling or updating other attributes.

Available options:

cancelled,

approved,

rejected

cancel_reason

string

Reason for cancelling the booking. Used when status is cancelled.

Example:

"I am not available"

rejection_reason

string

Reason for rejecting the booking. Used when status is rejected.

Example:

"Time slot no longer available"

meeting_outcome_id

string | null

Assign a meeting outcome to the booking by providing the outcome's ID. Pass null to remove the currently assigned outcome. This parameter cannot be combined with status or reschedule parameters (slot_date, slot_start_time) in the same request. Meeting outcomes can only be set on confirmed or parallel-error bookings. You can get the outcome ID from the List meeting outcomes endpoint.

Example:

"59413def-60eb-47c6-b390-098fcf583b66"

Response

200 - application/json

OK - Booking updated successfully

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

multihosts.name

string

Name of the host.

multihosts.email

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 place.

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 scheduling link.

no_show

boolean

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

is_overridden

boolean

Whether the booking was made or rescheduled outside the scheduling link's availability.

bypassed_rules

string[]

Messages for the availability checks skipped by override_availability (e.g., "Host is not available at the time"). Only included in the response to that create or update request.

meeting_outcome

object | null

Meeting outcome assigned to the booking.

Hide child attributes

meeting_outcome.id

string

Unique identifier for the meeting outcome.

Example:

"59413def-60eb-47c6-b390-098fcf583b66"

meeting_outcome.name

string

Name of the meeting outcome.

Example:

"Pricing Discussion"

meeting_outcome.color

enum<string>

Color assigned to the meeting outcome.

Available options:

blue,

orange,

gray,

red,

yellow,

violet,

pink,

teal,

cyan,

green

Example:

"yellow"

meeting_outcome.kind

string

Kind of the meeting outcome.

Example:

"custom"

meeting_outcome.color_hex

string

Hex color code for the meeting outcome.

Example:

"#EAB308"

meeting_outcome.is_system

boolean

Whether this is a system-defined meeting outcome. System outcomes cannot be modified or deleted.

Example:

false

meeting_outcome.is_organization_owned

boolean

Whether this outcome belongs to the organization.

Example:

true

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

form_responses.field

string

Display name of the form field.

form_responses.value

string

Value submitted for the form field.

form_responses.type

string

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

form_responses.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

add_on_services

object[]

Add-on services chosen for the booking.

Hide child attributes

add_on_services.id

string

Unique identifier for the booking's add-on service record.

Example:

"0d3c1e8a-58b7-4c1f-a7f3-3c2f5d1b9e10"

add_on_services.add_on_service_id

string

ID of the scheduling link's add-on service.

Example:

"77150ec6-d4f0-4665-98f0-34bda69f7b3a"

add_on_services.name

string

Example:

"Sauna"

add_on_services.duration

integer

Minutes the add-on service added to the booking.

Example:

30

add_on_services.amount

string

Price charged for the add-on service.

Example:

"25.5"

add_on_services.currency

string | null

Example:

"USD"

add_on_services.free

boolean

Whether the add-on service was free.

Example:

false

payment

object | null

Payment details for the booking. Included only when a payment exists for the booking.

Hide child attributes

payment.id

string<uuid>

Unique identifier of the payment record.

Example:

"f46c9ddf-221d-4238-afb2-280c1c6b3185"

payment.external_id

string | null

Payment reference ID from the payment provider.

Example:

"pi_3ThCkv2c3CtEndqE1BwejQno"

payment.provider

string

Payment provider that processed the payment.

Example:

"stripe"

payment.amount

string

Payment amount.

Example:

"100.0"

payment.currency

string

Currency code. Follows the ISO 4217 standard.

Example:

"USD"

payment.status

string

Current status of the payment.

Example:

"successful"

payment.successful

boolean

Whether the payment was completed successfully.

Example:

true

payment.payment_at

string<date-time> | null

Timestamp when the payment was made.

Example:

"2026-06-11T17:51:09.321Z"

Getting started

Scheduling links

Meeting places

Meeting durations

Add-on services

Calendar preferences

Bookings

Availabilities

Slots

Holidays

Packages

Team members

Meeting outcomes

Discount codes

Automation rules

Prefill tokens

API v1 (deprecated)

Update a booking

Headers

Path Parameters

Body

Response