Sign in
Job Materials

Create a new Job Material

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.

post/jobmaterial.json

Request body

uuidstring uuid

Unique identifier for this record

active0 | 1

Record active/deleted flag. Valid values are [0,1]

edit_datestring

Timestamp at which record was last modified

job_uuidstring uuid
material_uuidstring uuid
namestring
quantitystring required
pricestring
displayed_amountstring
displayed_amount_is_tax_inclusivestring
tax_rate_uuidstring uuid
sort_orderstring
coststring

The cost of the material for this job. This is the ex-tax amount.

displayed_coststring

The cost of the material for this job, displayed as inc-tax or ex-tax depending on jobMaterial.displayed_amount_is_tax_inclusive.

job_material_bundle_uuidstring uuid

UUID of a JobMaterialBundle which this JobMaterial belongs to. The default value is blank, which means that the JobMaterial is not part of a JobMaterialBundle.

Example request

{
  "uuid": "123e4567-2a5c-4493-a6a1-231eff7f786b",
  "edit_date": "2025-08-01 12:00:00",
  "job_uuid": "123e4567-017e-4378-a41a-231ef46ff44b",
  "material_uuid": "123e4567-db5b-41fd-b3a1-231ef6c09bfb",
  "tax_rate_uuid": "123e4567-46fe-4ec4-a83e-231ef7019a9b",
  "job_material_bundle_uuid": "123e4567-b99d-4c0b-90b0-231efe880ebb"
}

Response

Success

errorCodenumber
messagestring

Example response

{
  "message": "OK"
}

Changes