Create a job

post

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

Create a new job in Zenbooker. Supports scheduling jobs for existing services, and custom services.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

territory_id

string

required

The territory ID that this job will belong to

timeslot

object

provide either a timeslot object OR a timeslot_id string

timeslot_id

string

ID from timeslots API (e.g., slot_1760619600_1760634000)

customer

object

Customer info if not using existing customer_id (either this or customer_id required). If customer_id is not provided, the customer may be matched to an existing customer based on email, or a new customer will be created.

customer_id

string

Existing customer ID (either this or customer object required)

address

object

Service address

address_id

string

Use an existing address belonging to the customer (alternative to address object). Must be used with customer_id

services

array of objects

Each service in the services array must be either a catalog service or a custom service

services

duration

number

Job duration in minutes (defaults to calculated from services)

required_skills

array of strings

Array of required skill tags. When empty, applies skills from services

required_skills

min_providers_needed

string

Minimum number of providers required. When empty, applies from services. Always set to at least 1.

assigned_providers

array of strings

Array of pre-assigned provider IDs

assigned_providers

assignment_method

string

enum

Set to "auto" to auto-assign providers. Set to "offer" to offer to available providers.

Allowed:

manual_payment_method

string

Payment method ID for manual payments

sms_notifications

boolean

Defaults to false

Enable SMS notifications for the customer for this job. Make sure you collect permission from the customer before setting to true

email_notifications

boolean

Defaults to false

Enable email notifications for the customer for this job

tax_exempt

boolean

Defaults to false

Exempt job from any taxes that would be automatically applied

job_number

string

Optional custom job number. Should be 6 characters.

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Created

400Bad Request