---
title: "Create a new Job Material Bundle"
method: POST
path: "/jobmaterialbundle.json"
tags: ["Job Material Bundles"]
---

# Create a new Job Material Bundle

`POST /jobmaterialbundle.json`

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

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

- JobMaterialBundleCreate
  - `uuid` string, uuid — Unique identifier for this record
  - `item_number` string — Unique identifier for the material bundle within the job. Displayed on the Quote/Invoice in the same way as for JobMaterials.
  - `name` string — Descriptive name of the job material bundle. Displayed on the Quote/Invoice in the same way as for JobMaterials.
  - `quantity` string — The quantity shown for the bundle line item on the invoice. Must be greater than zero. The quantity of each JobMaterial within the bundle is determined by dividing by this value.
  - `sort_order` integer — Defines the display order of the JobMaterialBundle relative to other JobMaterials and JobMaterialBundles on the Job. Lower values are displayed first.
  - `material_bundle_uuid` string, uuid — UUID of the MaterialBundle which this JobMaterialBundle was originally created from.
  - `job_uuid` string, uuid — UUID of the job that this material bundle is associated with. Links the bundle to a specific job record.

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