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

- Job
  - `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` number, float — Longitude coordinate of the job location. Used for mapping and geolocation features. This is automatically populated based on the job address through geocoding.
  - `lat` number, float — Latitude coordinate of the job location. Used for mapping and geolocation features. This is automatically populated based on the job address through geocoding.
  - `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` string — 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_number` string — Client purchase order reference number for this job. Used for cross-referencing with external accounting or order management systems.
  - `invoice_sent` string — Boolean flag indicating whether an invoice has been sent to the client for this job.
  - `invoice_sent_stamp` string — Timestamp when the invoice was sent to the client. Format is YYYY-MM-DD HH:MM:SS.
  - `ready_to_invoice` unknown
  - `ready_to_invoice_stamp` unknown
  - `geo_country` string — The country component extracted from the geocoded job address. Automatically populated when an address is geocoded.
  - `geo_postcode` string — The postal/zip code component extracted from the geocoded job address. Automatically populated when an address is geocoded.
  - `geo_state` string — The state/province component extracted from the geocoded job address. Automatically populated when an address is geocoded.
  - `geo_city` string — The city/locality component extracted from the geocoded job address. Automatically populated when an address is geocoded.
  - `geo_street` string — The street name component extracted from the geocoded job address. Automatically populated when an address is geocoded.
  - `geo_number` string — The street number component extracted from the geocoded job address. Automatically populated when an address is geocoded.
  - `queue_uuid` string, uuid — UUID reference to the queue this job is assigned to. Jobs can be organized into queues for workflow management.
  - `queue_expiry_date` string — Timestamp when this job's assignment to the current Queue expires. After this date passes, the job is no longer considered to be in the Queue, even though queue_uuid may still contain a value.
  - `queue_assigned_staff_uuid` string, uuid — UUID of a Staff Member who is responsible for managing this job while it is in the queue. Only populated when the job is in a Queue which tracks Staff assignment.
  - `badges` string — Comma-separated list of Badge UUIDs associated with this job. Badges are visual indicators that can be displayed on jobs in the dispatch board.
  - `quote_date` string — Timestamp when the job was quoted. Automatically set when a job's status is changed to 'Quote'.
  - `quote_sent` 0 | 1 — Boolean flag indicating whether a quote has been sent to the client for this job. (Read only). Valid values are [0,1]
  - `quote_sent_stamp` string — Timestamp when the quote was sent to the client. Format is YYYY-MM-DD HH:MM:SS. (Read only)
  - `work_order_date` string — Timestamp when the job was converted to a work order. Automatically set when a job's status is changed to 'Work Order'.
  - `active_network_request_uuid` unknown
  - `related_knowledge_articles` unknown
  - `uuid` string, uuid — Unique identifier for this record
  - `active` 0 | 1 — Record active/deleted flag. Valid values are [0,1]
  - `edit_date` string — Timestamp at which record was last modified
  - `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
  - `generated_job_id` string — System-generated unique job identifier. This is read-only and automatically assigned when a job is created. (Read only)
  - `total_invoice_amount` string
  - `payment_processed` string
  - `payment_processed_stamp` string
  - `payment_received` string
  - `payment_received_stamp` string
  - `completion_date` string
  - `completion_actioned_by_uuid` string, uuid — UUID of the staff member who marked this job as completed. References a staff record in the system.
  - `unsuccessful_date` string
  - `job_is_scheduled_until_stamp` string

## Response `200`

Success

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

## Other responses

- `400` — Bad Request
- `default` — Unexpected error

---

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