post
https://connect.agendapro.com/v3/bookings/bulk
This endpoint creates up to 50 bookings in one request.
Important Notes
- Requires
bookings:writescope. - Each booking accepts the fields of
POST /v3/bookingsand gets its defaults
(creative_source=connect, the foursend_*flags =falsewhen omitted). Any other field
of a booking, and any field of the body other thanbookings, is dropped. - Connect only counts the bookings (at most 50). The shape of
bookingsand of each booking is
checked by the bookings service, which answers the errors below. - All bookings must belong to locations of the company. The batch is all or nothing: if
one booking fails, none is created and the error of the first failure is returned. - The request counts once against the rate limit, whatever the number of bookings.
- The response lists the created bookings in
data. - Each booking is independent (any clients); the embedded
clientofPOST /v3/bookingsis
not available here.
Errors Dictionary
Every error of this operation has error and detail, also the ones of a single booking: they
are not the legacy keys of POST /v3/bookings.
| Status | Error | Detail | Description |
|---|---|---|---|
| 400 | invalid_body | expected_object | Request body is not a JSON object. |
| 400 | invalid_body | malformed | Request body is not valid JSON. |
| 400 | required | bookings | bookings is missing, null or empty. |
| 400 | invalid_format | bookings | bookings is not a list, or some item of it is not an object. |
| 400 | required | location_id | No booking carries a location_id. |
| 401 | unauthorized | invalid_api_key | Missing or invalid Bearer token. |
| 401 | unauthorized | api_config_inactive | API access is inactive for this company. |
| 403 | forbidden | scope_denied | API key lacks bookings:write scope. |
| 404 | not_found | location | The locations of the bookings belong to another company. |
| 404 | not_found | bundle | A bundle_id does not exist. |
| 422 | max_bookings_exceeded | bookings | More than 50 bookings in one request (Connect's limit). |
| 422 | cross_company | bookings | The bookings span locations of more than one company. |
| 422 | cross_location | bookings | Bookings with a bundle_id belong to more than one location. |
| 422 | restricted | payment_status | The company's payment status blocks booking creation. |
| 4xx | {error} | {detail} | The first booking that fails, with the error and detail of the bookings service (for example unavailable/provider, with reasons, or mismatch/provider_service). Nothing is created. |
| 429 | rate_limited | burst_limit_exceeded | Per-minute request limit exceeded. |
| 429 | rate_limited | daily_quota_exceeded | Daily request quota exceeded. |
| 502 | upstream_unavailable | connection_failed | The upstream service is unavailable. |
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
