PUT

Update a booking

Scope: crm:booking-services.write https://api.alladdin.com/api/v2/bookings/{bookingId}

Updates the date/time and/or custom fields of an existing booking. At least one of date_time or custom_fields must be provided.

Parameters

Path parameters

bookingId string required

Booking ID (24-char hex ObjectId)

Request body

object date_time string<date-time> | null

New booking start time in the user's local timezone. Use ISO 8601 format without UTC offset (e.g. 2024-01-15T10:30:00) so the API interprets it in the account timezone. Do not use +00:00 — it will shift the stored time by the account's UTC offset. Date-only (e.g. 2024-01-15) is also accepted.

custom_fields[] object[] | null

Updated custom field values

key string

Custom field key

value string | null

Custom field value

Request

python

import requests

url = "https://api.alladdin.com/api/v2/bookings/{bookingId}"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

payload = {
    "date_time": "2024-01-15T10:30:00",
    "custom_fields": [
        {
            "key": "string",
            "value": "string"
        }
    ]
}
response = requests.put(url, headers=headers, json=payload)
print(response.json())

Responses

Response

json

{
  "id": "507f1f77bcf86cd799439011"
}

Success responses

200 Booking updated application/json object id string

Error responses

400 Bad request application/json 401 Invalid or missing API key application/json 403 Insufficient permissions application/json 404 Booking not found application/json 422 Validation error application/json 429 Rate limit exceeded application/json

← PreviousCreate a booking →

Next →List all bookings →

Alladdin