REST API
SUPPORTFEEDBACK
Start typing to search…

Creates a work order.

post
https://api.samsara.com/maintenance/work-orders

Creates a work order.

Rate limit: 100 requests/min (learn more about rate limits here).

To use this endpoint, select Write Work Orders under the Work Orders category when creating or editing an API token. Learn More.

Submit Feedback: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team.

Body Params
string
required

The ID of the asset.

string

The ID of the assigned mechanic.

string

The category of the work order

string

A description of what needs to be fixed.

discount
object

How much a work order is discounted. Either money or basisPoints are specified.

date-time

The due date of the work order in RFC 3339 format.

int64

The engine hours at the time of the work order. Will default to current asset reading if unset.

string

The invoice number for the work order.

items
array of objects

Items related to the work order.

items
int64

The odometer reading at the time of the work order. Will default to current asset reading if unset.

string

The purchase order number for the work order.

string
enum

The priority of the work order Valid values: High, Low, Medium, Urgent

Allowed:
serviceTaskInstances
array of objects

Service Tasks for the work order.

serviceTaskInstances
tax
object

How much tax is applied to a work order. Either money or basisPoints are specified. If not provided, the default tax rate will be used.

string

The vendor UUID for the work order.

Responses

Updated 6 months ago

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