---
title: "Create a new Job Queue"
method: POST
path: "/queue.json"
tags: ["Job Queues"]
---

# Create a new Job Queue

`POST /queue.json`

#### OAuth Scope
This endpoint requires the following OAuth scope **manage_job_queues**.

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

- Queue
  - `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
  - `name` string — Name of the job queue. Used to identify the queue in the system. Examples include 'Workshop', 'Pending Quotes', etc.
  - `default_timeframe` integer — Default number of days that jobs should remain in this queue before requiring attention. Common values are 7 days (1 week) or 14 days (2 weeks).
  - `subscribed_staff` string — Semicolon-delimited list of staff UUIDs who are subscribed to receive notifications for this queue.
  - `requires_assignment` 0 | 1 — Determines if jobs in this queue require assignment to staff members. If true, jobs must be explicitly assigned to staff. If false, jobs are visible to all staff.. Valid values are [0,1]

## 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/78fc015a96c8/schema)