GuidesAPI ReferenceDiscussions
API Reference

Create a new Job Material

post
https://api.servicem8.com/api_1.0/jobmaterial.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.

Body Params

Job Material record to create

uuid

The UUID of the job this material is associated with. This is a required field that establishes the relationship between the job material and its parent job.

uuid

The UUID of the material catalog item this job material is based on. Links the job material to the corresponding material in the materials catalog.

string
length ≤ 500

The name of the material item used on the job. This is displayed on invoices and is used to identify the material to the customer. The name typically comes from the associated material object but can be customized per job.

string
required
length ≤ 100

The quantity of this material used on the job. This field is mandatory and cannot be empty.

string

The unit price of the material excluding tax. Used in calculations to determine the total price for this line item on the job. The system may automatically adjust this value to maintain consistency with tax-inclusive pricing.

string

The unit price amount as displayed on invoices and quotes. This can be either tax-inclusive or tax-exclusive depending on the displayed_amount_is_tax_inclusive field value. Used for presentation to customers.

string

Boolean flag indicating whether the displayed_amount includes tax (true) or excludes tax (false). This controls how prices are presented to customers and determines which price value (inclusive or exclusive) is used in calculations.

uuid

The UUID of the tax rate applied to this job material. Determines how tax is calculated for this specific line item.

string

Integer value controlling the display order of materials on a job. Lower values appear first in lists. Used to customize the presentation order of materials on quotes, invoices and job forms.

string

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

string

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

uuid

Unique identifier for this record

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.

Responses

Updated 9 months ago

Language
Credentials
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated 9 months ago