---
title: "Create Job"
method: POST
path: "/jobs"
tags: ["jobs"]
---

# Create Job

`POST /jobs`

Use this endpoint to create a job in the milestone Lead (Unassigned).

This endpoint is rate limited. Use the `RateLimit-*` response headers to check current limits and remaining quota.

## Request body

- JobPost
  - `contact` ContactId, required
    - `id` string, uuid, required — The unique identifier of the contact.
  - `leadSource` LeadSourcePost
    - `id` string, uuid, required — Unique identifier of the lead source
  - `locationAddress` JobAddressPost
    - `street1` string, required
    - `street2` string
    - `city` string, required
    - `state` string, required
    - `country` string, required
    - `zipCode` string, required
  - `priority` 'Urgent' | 'High' | 'Normal' — Priority of lead (Urgent, High, Normal).
  - `jobCategory` JobCategoryPost
    - `id` integer — The category unique identifier.
  - `workType` WorkTypePost
    - `id` integer — The Work Type unique identifier.
  - `tradeTypes` TradeTypePost[]
    - `id` string, uuid — The trade type unique identifier.
  - `notes` string — A note or remark for this new Jobs.

## Response `201`

job created

- JobLink
  - `id` string, uuid — The job's unique ID.
  - `_link` string — The URI of this Job.

## Other responses

- `400` — Bad Request - The server cannot process the request due to a client error. Common causes: - Invalid request format - Missing required fields - Validation errors in the request data
- `401` — Unauthorized - Authentication is required or has failed. Common causes: - Missing API key - Invalid API key - Expired or deactivated API key
- `403` — Not enough permissions.
- `404` — Not Found - The requested resource does not exist. Common causes: - Invalid subscription ID - Subscription has been deleted - URL path contains typos or incorrect values
- `429` — Too Many Requests

---

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