---
title: "Create a Job"
method: POST
path: "/jobs"
---

# Create a Job

`POST /jobs`

## Query parameters

- `check_assignment_conflict` boolean

## Request body

- object
  - `job` object, required
    - `prefix` string
    - `job_title` string, required
    - `job_description` string
    - `job_category` string, required
    - `job_priority` 'LOW' | 'MEDIUM' | 'HIGH' | 'URGENT'
    - `job_type` 'NEW' | 'REVISIT'
    - `parent_job` string — Job UID
    - `job_tags` string[]
    - `scheduled_start_time` string, date-time — Due date or scheduled date is mandatory
    - `scheduled_end_time` string, date-time — Due date or scheduled date is mandatory
    - `assigned_to_team` object[]
      - `team_uid` string — Team UID
    - `assigned_to` object[]
      - `user_uid` string
      - `team_uid` string
    - `due_date` string, date-time — Due date or scheduled date is mandatory
    - `work_mins_required` number, double
    - `organization` string — Either customer or Organization is mandatory
    - `customer` object
      - `customer_first_name` string, required
      - `customer_last_name` string
      - `customer_category` string
      - `customer_organization` string
      - `account_manager` string
      - `customer_contact_no` string
      - `customer_email` string
      - `customer_tags` string[]
      - `custom_fields` object[]
        - `label` string, required
        - `value` string, required
        - `type` string, required
        - `ref_uid` string
        - `module_name` 'JOB' | 'CUSTOMER' | 'EMPLOYEE' | 'ESTIMATE' | 'INVOICE' | 'PRODUCT' | 'PURCHASE_ORDER' | 'SERVICE_CONTRACT' | 'ASSET' | 'PROPERTY' | 'ORGANIZATION' | 'TEAM' | 'REQUEST' | 'PROJECT'
        - `hide_to_fe` boolean
        - `hide_field` boolean
        - `read_only` boolean
        - `group_name` string
        - `group_uid` string
      - `customer_company_name` string
    - `customer_address` object
      - `city` string
      - `state` string
      - `street` string
      - `country` string
      - `landmark` string
      - `zip_code` string
      - `geo_cordinates` number[]
      - `first_name` string
      - `last_name` string
      - `phone_number` string — Customer phone number
      - `email` string — Customer email
      - `label` string — Label
    - `customer_billing_address` object
      - `city` string
      - `state` string
      - `street` string
      - `country` string
      - `landmark` string
      - `zip_code` string
      - `geo_cordinates` number[]
      - `first_name` string
      - `last_name` string
      - `phone_number` string — Customer phone number
      - `email` string — Customer email
      - `label` string — Label
    - `custom_fields` object[]
      - `label` string, required
      - `value` string, required
      - `type` string, required
      - `ref_uid` string
      - `module_name` 'JOB' | 'CUSTOMER' | 'EMPLOYEE' | 'ESTIMATE' | 'INVOICE' | 'PRODUCT' | 'PURCHASE_ORDER' | 'SERVICE_CONTRACT' | 'ASSET' | 'PROPERTY' | 'ORGANIZATION' | 'TEAM' | 'REQUEST' | 'PROJECT'
      - `hide_to_fe` boolean
      - `hide_field` boolean
      - `read_only` boolean
      - `group_name` string
      - `group_uid` string
    - `products` object[]
      - `line_item_type` 'ITEM' | 'HEADER'
      - `product_uid` string
      - `product_category` string
      - `product_no` string
      - `product_image` string
      - `product_name` string
      - `product_description` string
      - `brand` string
      - `specification` string
      - `uom` string
      - `product_manual_link` string
      - `quantity` string
      - `currency` string
      - `price` string
      - `product_type` string
      - `meta_data` string
      - `serial_nos` string[]
      - `location_uid` string
      - `location_name` string
      - `group_uid` string
      - `group_name` string
      - `discount` string
      - `purchase_price` string
      - `discount_type` string
      - `total` string
      - `section_name` string
      - `section_uid` string
      - `section_type` 'COLLAPSED' | 'EXPANDED' | 'HIDDEN'
      - `show_child_prices` boolean
      - `show_section_total` boolean
      - `tax` object
        - `tax_name` string
        - `tax_rate` string
        - `tax_amount` string
    - `customer_uid` string — 1st priority to read customer data and map accordingly Either customer or organization is mandatory
    - `assets` object[] — Asset UID
      - `asset` string — asset uid
    - `ppm` string
    - `service_contract` string
    - `route` string
    - `property` string
    - `request` string
    - `order_id` string
    - `skills` object[]
      - `skill_uid` string
      - `skill_name` string
    - `invoice` string
    - `service_task` object
      - `is_enabled` boolean
      - `execution_type` 'SERIES' | 'PARALLEL'
      - `service_tasks` object[]
        - `sequence_no` integer
        - `service_task_master` string
        - `service_task_title` string
        - `service_task_description` string
        - `estimated_duration` object
          - `days` integer
          - `hours` integer
          - `minutes` integer
        - `inspection_form` string
        - `asset` string
    - `attachments` object[]
      - `file_name` string, required
      - `url` string, required
      - `file_size` integer
      - `visible_to_customer` boolean
    - `recurrence_dates` object[]
      - `scheduled_start_time` string, date-time
      - `scheduled_end_time` string, date-time
    - `rrule` object
      - `rule_string` string
      - `duration` object
        - `value` string
        - `type` string
    - `secondary_customers` object[]
      - `customer` string, required — customer_uid
    - `bu_uid` string — Trade Type UID
    - `appointment` object — Only if appointments is enabled and for dispatchable jobs
      - `appointment_title` string
      - `scheduled_start_time` string, date-time
      - `scheduled_end_time` string, date-time
      - `bu_uid` string
      - `users` object[]
        - `user_uid` string
        - `team_uid` string
      - `description` string

## Response `200`

200

- object
  - `type` string
  - `message` string
  - `job_uid` string
  - `customer_uid` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/zuper/apis/zuper-pro-api.md) · [All operations](https://skmtc.net/zuper/apis/zuper-pro-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zuper/zuper-pro-api/versions/c7b8028a05de/schema)