PUT
Update a booking
Scope:
crm:booking-services.writehttps://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
bookingId
stringrequiredBooking 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/jsonobject
idstring
Error responses
400Bad requestapplication/json401Invalid or missing API keyapplication/json403Insufficient permissionsapplication/json404Booking not foundapplication/json422Validation errorapplication/json429Rate limit exceededapplication/json