---
title: "Create a new Job"
method: POST
path: "/job.json"
tags: ["Jobs"]
---

# Create a new Job

`POST /job.json`

#### 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.

## Request body

- JobCreate
  - `created_by_staff_uuid` string, uuid — UUID of the staff member who created this job. Records which staff member initially added the job to the system.
  - `date` string — The date the job was created or scheduled. Used for organizing jobs chronologically and for reference in reports.
  - `company_uuid` string, 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_address` string — 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]
  - `lng` unknown
  - `lat` unknown
  - `payment_date` string — Not used. Refer to JobPayment endpoint.
  - `payment_actioned_by_uuid` string, uuid — Not used. Refer to JobPayment endpoint.
  - `payment_method` string — Not used. Refer to JobPayment endpoint.
  - `payment_amount` string — Not used. Refer to JobPayment endpoint.
  - `category_uuid` string, uuid — UUID reference to the job category this job belongs to. Categories help organize jobs by type of work or department.
  - `payment_note` string — Not used. Refer to JobPayment endpoint.
  - `geo_is_valid` unknown
  - `purchase_order_number` string — Client purchase order reference number for this job. Used for cross-referencing with external accounting or order management systems.
  - `invoice_sent` 0 | 1 — Indicates whether an invoice has been sent for this job.. Valid values are [0,1]
  - `invoice_sent_stamp` unknown
  - `ready_to_invoice` unknown
  - `ready_to_invoice_stamp` unknown
  - `geo_country` unknown
  - `geo_postcode` unknown
  - `geo_state` unknown
  - `geo_city` unknown
  - `geo_street` unknown
  - `geo_number` unknown
  - `queue_uuid` string, uuid — The UUID of the queue this job belongs to.
  - `queue_expiry_date` string — The date and time when the job expires from the queue.
  - `queue_assigned_staff_uuid` string, uuid — The UUID of the staff member assigned to this job in the queue.
  - `badges` string — JSON Array of Badge UUIDs
  - `quote_date` string — The date and time that the job status was changed to Quote.
  - `quote_sent` 0 | 1 — Boolean flag indicating whether a quote has been sent to the client for this job.. Valid values are [0,1]
  - `quote_sent_stamp` unknown
  - `work_order_date` string — The date and time that the job status was changed to Work Order.
  - `active_network_request_uuid` unknown
  - `related_knowledge_articles` unknown
  - `uuid` string, uuid — Unique identifier for this record
  - `job_address` string — Physical address where the job is to be performed. This address is used for geocoding to place the job on the map.
  - `job_description` string
  - `work_done_description` string — Email Address
  - `payment_processed` 0 | 1 — Indicates whether the job has been exported to the connected Accounting Package.. Valid values are [0,1]
  - `payment_received` 0 | 1 — Indicates whether full payment has been received for this job.. Valid values are [0,1]
  - `completion_date` string — The date and time that the job status was changed to Completed.
  - `unsuccessful_date` string — The date and time that the job status was changed to Unsuccessful.

## Response `200`

Success

- Result
  - `errorCode` number
  - `message` string

## Other responses

- `400` — Bad Request - The request is malformed or contains invalid parameters
- `401` — Unauthorized - Authentication credentials are missing or invalid
- `403` — Forbidden - You don't have permission to create this resource
- `429` — Too Many Requests - You have exceeded the rate limit
- `500` — Internal Server Error - An unexpected error occurred on the server

---

[API](https://skmtc.net/servicem8/apis/servicem8-api.md) · [All operations](https://skmtc.net/servicem8/apis/servicem8-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/servicem8/servicem8-api/revisions/53ede60e3653/schema)