Create a service request

post

https://api.zenbooker.com/v1/service_requests

Creates a booking request or quote request for one or more services

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

territory_id

string

required

Territory (service area) ID.

request_type

string

enum

required

Allowed:

requested_dates

array

Preferred times, not reservations. Required and nonempty for booking_request; optional for quote_request.

requested_dates

services

array

required

length ≥ 1

At least one catalog or one-off custom service.

services*

service_id

string

required

Catalog service ID.

selections

Section answers. Array recommended; legacy section-ID-keyed object also accepted.

customer_id

string

Existing customer ID; send this or customer, not both.

customer

object

New customer; send this or customer_id, not both. Email may match an existing customer.

address_id

string

Existing address ID; send this or address, not both.

address

object

New service address; send this or address_id, not both.

price_adjustments

array of strings

Fee/discount IDs; unknown IDs cause UNKNOWN_ADJUSTMENTS.

price_adjustments

required_skills

array of strings

Provider skills; defaults to the selected services' skills.

required_skills

min_providers_needed

integer

≥ 1

Defaults to the services' setting or 1.

duration

integer

≥ 0

Minutes; defaults to total service and option duration.

201Created service request, not wrapped in data. Empty strings are returned as null. Money values are decimal strings in the business's currency.

401Missing, malformed or invalid API key. Treat any 401 as authentication failure; codes vary.

500Server-side failure; codes include ACCOUNT_ERROR, SERVICE_FETCH_ERROR, and JOB_CREATION_ERROR.