Create a job request
createJobRequestBook a field-operations job into the dispatch and scheduling pipeline by sending the customer UUID plus requested date/time periods; add optional skills and job type to direct assignment.
Instructions
Create a job request
Books a field-operations job — the work order that enters the dispatch & scheduling pipeline. Send the customer's UUID plus requested job_dates (date + morning/afternoon/evening periods, ideally offered from GET /job-requests/booking-windows), optional job_type_id (service catalog), skill_ids (required technician qualifications) and a free-text description. Quoting, technician/crew assignment and completion then advance the work order through the business's workflow.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| priority | No | Scheduling priority. Optional; omitted bookings receive the business's default_priority setting (assignment settings, default p2). p0=emergency (interrupt-driven insert), p1=top (displaced only by p0), p2=standard, p3=deferrable (first candidate for displacement). | |
| job_dates | Yes | Requested date(s) + period(s) the customer wants the job. At least one, up to 12. | |
| skill_ids | No | UUIDs of the skills the customer desires for this job. Optional; up to 20. | |
| x_timezone | No | Customer IANA timezone (sent as the X-Timezone header) | |
| customer_id | Yes | UUID of an existing customer of this business to book the job for. Required. | |
| description | No | Free-text description of the work requested. Optional; max 2000 chars. | |
| job_type_id | No | UUID of the job type to classify this job. Optional; null leaves the job unclassified. | |
| sla_deadline | No | SLA deadline (business-local naive datetime, e.g. "2030-06-14T17:00:00"). Optional; ONLY valid together with priority=p1 — arms the auto-escalation clock (the job escalates to p0 as breach risk crosses the business's safety buffer). Must be in the future. | |
| idempotency_key | No | Unique key making retries safe: a repeat send with the same key returns the original booking instead of creating a duplicate (sent as the Idempotency-Key header) |