Skip to main content
PUT

Update a booking

Scope:crm:booking-services.write
https://api.holded.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

bookingIdstringrequired

Booking ID (24-char hex ObjectId)

Request body

object
date_timestring<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

keystring

Custom field key

valuestring | null

Custom field value

Request

python
import requests

url = "https://api.holded.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

200Booking updatedapplication/json
object
idstring

Error responses

400Bad requestapplication/json
401Invalid or missing API keyapplication/json
403Insufficient permissionsapplication/json
404Booking not foundapplication/json
422Validation errorapplication/json
429Rate limit exceededapplication/json