Create a new work order.
Create a new work order. Provide the essential details for the job; the response returns the newly created work order with identifiers.
access_token OAuth 2.0 Access Token
In: query
Process the request asynchronously
true | falseapplication/json
Work order model
TypeScript Definitions
Use the request body type in TypeScript.
curl -X POST "https://api-sandbox.fndev.net/api/rest/v2/workorders" \ -H "Content-Type: application/json" \ -d '{ "title": "Install Digital Signage", "description": { "html": "Install 2 Samsung displays in the lobby" }, "types_of_work": [ { "id": 40, "is_primary": true } ], "location": { "mode": "custom", "address1": "123 Main St", "city": "San Francisco", "state": "CA", "zip": "94105", "country": "USA" }, "schedule": { "service_window": { "mode": "exact", "start": { "utc": "2026-02-01T17:00:00Z", "local": { "date": "2026-02-01", "time": "09:00:00" } }, "end": { "utc": "2026-02-01T18:00:00Z", "local": { "date": "2026-02-01", "time": "10:00:00" } } } }, "pay": { "base": { "amount": 150, "units": 1 }, "type": "fixed" } }'{
"id": 20546,
"work_order_id": 20546,
"title": "Install Point of Sale Terminal",
"status": {
"id": 3,
"name": "Assigned",
"display": "Checked out",
"code": "checked_out",
"is_routed": false,
"delay": 0,
"ncns": true,
"sub_status": "",
"confirmed": true,
"correlation_id": "139afced528488f08884c5e0d75e23b8cca1f729"
},
"type_of_work": {
"id": 62,
"name": "Point of Sale (POS)"
},
"location": {
"coordinates": {
"latitude": 44.8963,
"longitude": -93.2682,
"exact": true
},
"work_order_id": 20546,
"mode": "custom",
"address1": "1254 Commerce Lane",
"address2": "",
"city": "Minneapolis",
"state": "MN",
"zip": "55402",
"country": "US",
"notes": [],
"type": {
"id": 1,
"name": "Commercial"
},
"saved_location": {
"id": 0,
"name": "",
"display_name": "",
"contact": {
"name": "",
"phone": ""
},
"group": {
"id": 0,
"name": ""
}
},
"display_name": "1254 Commerce Lane, Minneapolis, MN 55402",
"status_id": 3,
"correlation_id": "d3f8591566b5bf59a06279cedc02501bc16bbb6e",
"zoom": "13z",
"map": {
"url": "https://maps.fieldnation.com/static/-93.2682,44.8963,13",
"href": "https://www.google.com/maps/search/1254+Commerce+Lane+Minneapolis+MN+55402/@44.8963,-93.2682,13z"
},
"actions": []
}
}{
"status": 400,
"message": "Validation failed: field 'title' is required"
}{
"status": 500,
"message": "Operation successful."
}{
"status": 403,
"message": "You do not have permission to access this work order"
}{
"status": 500,
"message": "An unexpected error occurred. Please try again later or contact support."
}application/json
application/json
application/json
application/json
application/json
Last updated on
ID of the incident
Client ID
Client ID
ID of the default template
Whether the work order is a universal template
Client ID
Client ID
Client ID
Network information
Whether the work order is printable
Whether counter offers are allowed
Whether GPS is required
Site revisit information
Service types
Equipment information
Client ID
Contacts
Description of the work order
Description of the work order
Tasks associated with the work order
Custom fields
Location information
Schedule information
Whether on-time arrival is required
Pay information
Shipment information
Auto-dispatch rule
Smart audit rule ID
Whether to ignore the template
Whether qualifications are enabled
DEPRECATED FOR CREATE: The array form is rejected by the API with 400 'Invalid types of work'. Use type_of_work: {id: N} instead for creating work orders.
Title of the work order
Client ID