Sign in
Jobs

Create a new Job

OAuth Scope

This endpoint requires the following OAuth scope create_jobs.

Record UUID

UUID is optional for record creation. If no UUID is supplied, a UUID will be automatically generated for the new record and returned in the x-record-uuid response header.

post/job.json

Request body

created_by_staff_uuidstring uuid

UUID of the staff member who created this job. Records which staff member initially added the job to the system.

datestring

The date the job was created or scheduled. Used for organizing jobs chronologically and for reference in reports.

company_uuidstring uuid

UUID reference to the client/company record associated with this job. Links the job to a client in the system, establishing the client-job relationship for billing and contact purposes.

billing_addressstring

The address where invoices and billing information should be sent. If not specified, defaults to the job address.

status'Quote' | 'Work Order' | 'Unsuccessful' | 'Completed' required

Current status of the job. Controls where the Job appears in the Dispatch Board.. Valid values are [Quote,Work Order,Unsuccessful,Completed]

{"stackTrail":"components:schemas:JobCreate:properties:lng","oasType":"schema","type":"unknown","description":"Longitude coordinate of the job location. Used for mapping and geolocation features. This is automatically populated based on the job address through geocoding."}
{"stackTrail":"components:schemas:JobCreate:properties:lat","oasType":"schema","type":"unknown","description":"Latitude coordinate of the job location. Used for mapping and geolocation features. This is automatically populated based on the job address through geocoding."}
payment_datestring

Not used. Refer to JobPayment endpoint.

payment_actioned_by_uuidstring uuid

Not used. Refer to JobPayment endpoint.

payment_methodstring

Not used. Refer to JobPayment endpoint.

payment_amountstring

Not used. Refer to JobPayment endpoint.

category_uuidstring uuid

UUID reference to the job category this job belongs to. Categories help organize jobs by type of work or department.

payment_notestring

Not used. Refer to JobPayment endpoint.

{"stackTrail":"components:schemas:JobCreate:properties:geo_is_valid","oasType":"schema","type":"unknown","description":"Indicates whether the geocoding for the job address was successful. When true, the latitude and longitude coordinates are considered accurate for mapping and location-based features."}
purchase_order_numberstring

Client purchase order reference number for this job. Used for cross-referencing with external accounting or order management systems.

invoice_sent0 | 1

Indicates whether an invoice has been sent for this job.. Valid values are [0,1]

{"stackTrail":"components:schemas:JobCreate:properties:invoice_sent_stamp","oasType":"schema","type":"unknown","description":"Timestamp when the invoice was sent to the client. Format is YYYY-MM-DD HH:MM:SS."}
{"stackTrail":"components:schemas:JobCreate:properties:ready_to_invoice","oasType":"schema","type":"unknown","description":"DEPRECATED"}
{"stackTrail":"components:schemas:JobCreate:properties:ready_to_invoice_stamp","oasType":"schema","type":"unknown","description":"DEPRECATED"}
{"stackTrail":"components:schemas:JobCreate:properties:geo_country","oasType":"schema","type":"unknown","description":"The country component extracted from the geocoded job address. Automatically populated when an address is geocoded."}
{"stackTrail":"components:schemas:JobCreate:properties:geo_postcode","oasType":"schema","type":"unknown","description":"The postal/zip code component extracted from the geocoded job address. Automatically populated when an address is geocoded."}
{"stackTrail":"components:schemas:JobCreate:properties:geo_state","oasType":"schema","type":"unknown","description":"The state/province component extracted from the geocoded job address. Automatically populated when an address is geocoded."}
{"stackTrail":"components:schemas:JobCreate:properties:geo_city","oasType":"schema","type":"unknown","description":"The city/locality component extracted from the geocoded job address. Automatically populated when an address is geocoded."}
{"stackTrail":"components:schemas:JobCreate:properties:geo_street","oasType":"schema","type":"unknown","description":"The street name component extracted from the geocoded job address. Automatically populated when an address is geocoded."}
{"stackTrail":"components:schemas:JobCreate:properties:geo_number","oasType":"schema","type":"unknown","description":"The street number component extracted from the geocoded job address. Automatically populated when an address is geocoded."}
queue_uuidstring uuid

The UUID of the queue this job belongs to.

queue_expiry_datestring

The date and time when the job expires from the queue.

queue_assigned_staff_uuidstring uuid

The UUID of the staff member assigned to this job in the queue.

badgesstring

JSON Array of Badge UUIDs

quote_datestring

The date and time that the job status was changed to Quote.

quote_sent0 | 1

Boolean flag indicating whether a quote has been sent to the client for this job.. Valid values are [0,1]

{"stackTrail":"components:schemas:JobCreate:properties:quote_sent_stamp","oasType":"schema","type":"unknown","description":"Timestamp when the quote was sent to the client. Format is YYYY-MM-DD HH:MM:SS."}
work_order_datestring

The date and time that the job status was changed to Work Order.

{"stackTrail":"components:schemas:JobCreate:properties:active_network_request_uuid","oasType":"schema","type":"unknown","description":"DEPRECATED"}
{"stackTrail":"components:schemas:JobCreate:properties:related_knowledge_articles","oasType":"schema","type":"unknown","description":"DEPRECATED"}
uuidstring uuid

Unique identifier for this record

job_addressstring

Physical address where the job is to be performed. This address is used for geocoding to place the job on the map.

job_descriptionstring
work_done_descriptionstring

Email Address

payment_processed0 | 1

Indicates whether the job has been exported to the connected Accounting Package.. Valid values are [0,1]

payment_received0 | 1

Indicates whether full payment has been received for this job.. Valid values are [0,1]

completion_datestring

The date and time that the job status was changed to Completed.

unsuccessful_datestring

The date and time that the job status was changed to Unsuccessful.

Example request

{
  "created_by_staff_uuid": "123e4567-f7ec-44f1-8f82-23f94fdc6cab",
  "date": "YYYY-MM-DD",
  "company_uuid": "123e4567-9fc3-4f4c-ae8c-23f94a2a432b",
  "payment_date": "2026-03-01 12:00:00",
  "payment_actioned_by_uuid": "123e4567-e130-4744-bf68-23f94937a7eb",
  "category_uuid": "123e4567-5651-43fe-a6f2-23f94a6f9c7b",
  "queue_uuid": "123e4567-e5cb-43ec-8a27-23f948619a1b",
  "queue_expiry_date": "2026-03-01 12:00:00",
  "queue_assigned_staff_uuid": "123e4567-3588-4466-8265-23f9431c9d3b",
  "quote_date": "2026-03-01 12:00:00",
  "work_order_date": "2026-03-01 12:00:00",
  "uuid": "123e4567-8032-4212-ae45-23f94e9e212b",
  "completion_date": "2026-03-01 12:00:00",
  "unsuccessful_date": "2026-03-01 12:00:00"
}

Response

Success

errorCodenumber
messagestring

Example response

{
  "message": "OK"
}

Changes

Changed in 3 of the 50 revisions of this API.21712

  • 638a8df09bf4137See the full diff
    • ▲

      removed the enum value 0.00 of the request property geo_is_valid

      request-property-enum-value-removed

    • ▲

      removed the enum value 1.00 of the request property geo_is_valid

      request-property-enum-value-removed

    • ▲

      the geo_city request property type/format changed from string/ to /

      request-property-type-changed

    • ▲

      the geo_country request property type/format changed from string/ to /

      request-property-type-changed

    • ▲

      the geo_is_valid request property type/format changed from integer/ to /

      request-property-type-changed

    • ▲

      the geo_number request property type/format changed from string/ to /

      request-property-type-changed

    • ▲

      the geo_postcode request property type/format changed from string/ to /

      request-property-type-changed

    • ▲

      the geo_state request property type/format changed from string/ to /

      request-property-type-changed

    • ▲

      the geo_street request property type/format changed from string/ to /

      request-property-type-changed

    • ▲

      the invoice_sent_stamp request property type/format changed from string/ to /

      request-property-type-changed

    • ▲

      the lat request property type/format changed from number/float to /

      request-property-type-changed

    • ▲

      the lng request property type/format changed from number/float to /

      request-property-type-changed

    • ▲

      the quote_sent_stamp request property type/format changed from string/ to /

      request-property-type-changed

    • ●

      removed the request property active

      request-property-removed

    • ●

      removed the request property completion_actioned_by_uuid

      request-property-removed

    • ●

      removed the request property generated_job_id

      request-property-removed

    • ●

      removed the request property job_is_scheduled_until_stamp

      request-property-removed

    • ●

      removed the request property payment_processed_stamp

      request-property-removed

    • ●

      removed the request property payment_received_stamp

      request-property-removed

    • ●

      removed the request property total_invoice_amount

      request-property-removed

  • ca9b053c43734See the full diff
    • ○

      added the non-success response with the status 401

      response-non-success-status-added

    • ○

      added the non-success response with the status 403

      response-non-success-status-added

    • ○

      added the non-success response with the status 429

      response-non-success-status-added

    • ○

      added the non-success response with the status 500

      response-non-success-status-added

  • f2e41074a46888See the full diff
    • ▲

      request property geo_is_valid was restricted to a list of enum values

      request-property-became-enum

    • ▲

      request property invoice_sent was restricted to a list of enum values

      request-property-became-enum

    • ▲

      request property payment_processed was restricted to a list of enum values

      request-property-became-enum

    • ▲

      request property payment_received was restricted to a list of enum values

      request-property-became-enum

    • ▲

      the geo_is_valid request property type/format changed from string/ to integer/

      request-property-type-changed

    • ▲

      the invoice_sent request property type/format changed from string/ to integer/

      request-property-type-changed

    • ▲

      the payment_processed request property type/format changed from string/ to integer/

      request-property-type-changed

    • ▲

      the payment_received request property type/format changed from string/ to integer/

      request-property-type-changed

    • ○

      added the new 0.00 enum value to the request property geo_is_valid

      request-property-enum-value-added

    • ○

      added the new 0.00 enum value to the request property invoice_sent

      request-property-enum-value-added

    • ○

      added the new 0.00 enum value to the request property payment_processed

      request-property-enum-value-added

    • ○

      added the new 0.00 enum value to the request property payment_received

      request-property-enum-value-added

    • ○

      added the new 1.00 enum value to the request property geo_is_valid

      request-property-enum-value-added

    • ○

      added the new 1.00 enum value to the request property invoice_sent

      request-property-enum-value-added

    • ○

      added the new 1.00 enum value to the request property payment_processed

      request-property-enum-value-added

    • ○

      added the new 1.00 enum value to the request property payment_received

      request-property-enum-value-added