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": "site", "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": 123,
"work_order_id": 1001,
"title": "string_value",
"href": "string_value",
"networks": {
"metadata": {
"total": 100,
"page": 0,
"pages": 5,
"per_page": 20
},
"actions": [],
"results": [],
"active": {
"id": 123,
"name": "Sample Name",
"type": "standard",
"options": [],
"company_options": [],
"sourced_providers": [],
"actions": []
}
},
"attachments": {
"correlation_id": "string_value",
"actions": [],
"sum": {
"unreviewed": 0
},
"metadata": {
"total": 100,
"page": 0,
"pages": 5,
"per_page": 20
},
"results": []
},
"shipments": {
"metadata": {
"total": 100,
"page": 0,
"pages": 5,
"per_page": 20
},
"results": [],
"correlation_id": "string_value",
"actions": []
},
"signatures": {
"metadata": {
"total": 100,
"page": 0,
"pages": 5,
"per_page": 20
},
"results": [],
"correlation_id": "string_value",
"actions": []
},
"time_logs": {
"metadata": {
"total": 100,
"page": 1,
"pages": 10,
"per_page": 20
},
"results": [],
"correlation_id": "string_value",
"actions": [],
"hours": 0
},
"problems": {
"metadata": {
"total": 100,
"page": 0,
"pages": 5,
"per_page": 20
},
"sum": {
"active": 0,
"resolved": 0
},
"correlation_id": "string_value",
"actions": [],
"types": [],
"results": [],
"active": {
"id": 123,
"zendesk_ticket_id": 0,
"type": {
"id": 123,
"name": "Sample Name",
"other": "string_value"
},
"comments": "string_value",
"use_provider": true,
"only_company_can_mark_resolved": true,
"resolution": {
"status": "active",
"at": {
"date": "2025-01-01",
"time": "12:00:00",
"utc": "string_value"
},
"by": {
"id": 123,
"first_name": "John",
"last_name": "Doe"
},
"allowed_resolvers": []
},
"author": {
"id": 123,
"first_name": "John",
"last_name": "Doe"
},
"created": {
"utc": "string_value",
"local": {
"date": "2025-01-01",
"time": "12:00:00"
}
},
"message": {
"id": 123
},
"escalate": true,
"actions": []
}
},
"pay": {
"work_order_id": 1001,
"type": "fixed",
"base": {
"units": 0,
"amount": 0
},
"additional": {
"units": 0,
"amount": 50
},
"fees": [],
"finance": {
"id": 123,
"terms": "string_value",
"description": "Sample description text.",
"limit": 0,
"invoiced_account": true,
"locked": true
},
"hold": {
"id": 123,
"amount": 50,
"charged": true
},
"hours": 0,
"reported_hours": 0,
"number_of_devices": 0,
"minimum_payment": 0,
"range": {
"min": 0,
"max": 0
},
"labor_sum": 0,
"fees_cancellation_pending": true,
"passive_cancellation_amount": 0,
"fee_cancellation_queued": "string_value",
"fee_cancellation_charged": "string_value",
"status_id": "string_value",
"funding": [],
"invoice": {
"id": 123,
"sent": {
"utc": "string_value",
"local": {
"date": "2025-01-01",
"time": "12:00:00"
}
},
"paid": {
"utc": "string_value",
"local": {
"date": "2025-01-01",
"time": "12:00:00"
}
}
},
"bonuses": {
"metadata": {
"total": 100,
"page": 0,
"pages": 5,
"per_page": 20
},
"sum": {
"all": 0,
"charged": 0,
"uncharged": 0
},
"results": [],
"actions": []
},
"expenses": {
"metadata": {
"total": 100,
"page": 0,
"pages": 5,
"per_page": 20
},
"sum": {
"all": 0,
"charged": 0,
"uncharged": 0,
"pending": 0,
"approved": 0,
"approved_amount": 0,
"denied": 0
},
"results": [],
"actions": []
},
"penalties": {
"metadata": {
"total": 100,
"page": 0,
"pages": 5,
"per_page": 20
},
"sum": {
"all": 0,
"charged": 0,
"uncharged": 0
},
"results": [],
"actions": []
},
"discounts": {
"metadata": {
"total": 100,
"page": 0,
"pages": 5,
"per_page": 20
},
"sum": {
"all": 0
},
"results": [],
"actions": []
},
"increases": {
"metadata": {
"total": 100,
"page": 0,
"pages": 5,
"per_page": 20
},
"sum": {
"all": 0
},
"results": [],
"actions": [],
"minimum": 0
},
"max_pay": 0,
"total": 100,
"max_pay_limit": 0,
"calculated_total": {
"total": {
"min": 0,
"max": 0
}
}
},
"publish_stats": {
"requests": 0,
"published": 0,
"failed": 0
},
"routes": {
"metadata": {
"total": 100,
"page": 0,
"pages": 5,
"per_page": 20
},
"sum": {
"all": 0
},
"results": [],
"actions": []
},
"custom_fields": {
"metadata": {
"total": 100,
"page": 0,
"pages": 5,
"per_page": 20
},
"internal": {
"id": 123,
"name": "Sample Name",
"value": "string_value",
"role": "string_value"
},
"actions": [],
"correlation_id": "string_value",
"results": []
},
"qualifications": {
"ignored_missing_qualifications": true,
"actions": [],
"correlation_id": "string_value",
"selection_rule": {
"id": 123,
"name": "Sample Name",
"status": "active",
"actions": [],
"total_selection_rule": "string_value",
"weight": 0,
"sum": {
"total": 100,
"match": 0,
"no_match_optional": 0,
"no_match_required": 0
},
"metadata": {
"total": 100,
"page": 0,
"pages": 5,
"per_page": 20
},
"results": []
}
},
"bundle": {
"id": 123,
"company_id": 0,
"metadata": {
"total": 100,
"per_page": 20
},
"actions": [],
"results": []
},
"auto_dispatch_stats": {
"auto_assigned": true
},
"schedule": {
"work_order_id": 1001,
"service_window": {
"mode": "exact",
"start": {
"utc": "string_value",
"local": {
"date": "2025-01-01",
"time": "12:00:00"
}
},
"end": {
"utc": "string_value",
"local": {
"date": "2025-01-01",
"time": "12:00:00"
}
}
},
"schedule_note": "string_value",
"schedule_option": 0,
"time_zone": {
"name": "Sample Name",
"short": "string_value",
"id": 123,
"offset": 0
},
"status_id": 0,
"company_id": 0,
"today_tomorrow": "string_value",
"correlation_id": "string_value"
},
"eta": {
"user": {
"id": 123
},
"task": {
"id": 123
},
"start": {
"utc": "string_value",
"local": {
"date": "2025-01-01",
"time": "12:00:00"
}
},
"end": {
"utc": "string_value",
"local": {
"date": "2025-01-01",
"time": "12:00:00"
}
},
"hour_estimate": 0,
"notes": "string_value",
"status": {
"name": "Sample Name",
"updated": {
"utc": "string_value",
"local": {
"date": "2025-01-01",
"time": "12:00:00"
}
}
},
"mode": "string_value"
},
"location": {
"coordinates": {
"latitude": 44.9778,
"longitude": -93.265,
"exact": true
},
"work_order_id": 1001,
"mode": "string_value",
"address1": "123 Main St",
"address2": "Suite 100",
"city": "Minneapolis",
"state": "MN",
"zip": "90210",
"country": "USA",
"notes": [],
"type": {
"id": 123,
"name": "Sample Name"
},
"saved_location": {
"id": 123,
"name": "Sample Name",
"display_name": "string_value",
"contact": {
"name": "Sample Name",
"phone": "555-0199"
},
"group": {
"id": 123,
"name": "Sample Name"
}
},
"display_name": "string_value",
"status_id": 0,
"correlation_id": "string_value",
"zoom": "string_value",
"map": {
"url": "https://fieldnation.com",
"href": "string_value"
},
"actions": []
},
"company": {
"id": 123,
"name": "Sample Name",
"photo": "string_value",
"check_in_instructions": "string_value",
"check_out_instructions": "string_value",
"provider_utilization_max_hours": 0,
"provider_utilization_max_weekly": 0,
"address": {
"address1": "123 Main St",
"address2": "Suite 100",
"city": "Minneapolis",
"state": "MN",
"postalCode": "string_value",
"country": "USA"
},
"features": []
},
"manager": {
"thumbnail": "string_value",
"id": 123,
"username": "string_value",
"first_name": "John",
"last_name": "Doe",
"name": "Sample Name",
"email": "user@fieldnation.com",
"phone": "555-0199"
},
"client": {
"id": 123,
"name": "Sample Name"
},
"project": {
"id": 123,
"name": "Sample Name"
},
"status": {
"id": 123,
"name": "Sample Name",
"display": "string_value",
"is_routed": true,
"code": "string_value",
"delay": 0,
"ncns": true,
"sub_status": "string_value",
"confirmed": true,
"correlation_id": "string_value"
},
"messages": {
"actions": [],
"correlation_id": "string_value",
"metadata": {
"total": 100,
"page": 0,
"pages": 5,
"per_page": 20
},
"results": []
},
"assignee": {
"user": {
"id": 123,
"first_name": "John",
"last_name": "Doe"
},
"status_id": 0,
"work_order_id": 1001,
"in_confirmation_window": true
},
"milestones": {
"created": {
"utc": "string_value",
"local": {
"date": "2025-01-01",
"time": "12:00:00"
}
},
"published": {
"utc": "string_value",
"local": {
"date": "2025-01-01",
"time": "12:00:00"
}
},
"routed": {
"utc": "string_value",
"local": {
"date": "2025-01-01",
"time": "12:00:00"
}
},
"assigned": {
"utc": "string_value",
"local": {
"date": "2025-01-01",
"time": "12:00:00"
}
},
"workdone": {
"utc": "string_value",
"local": {
"date": "2025-01-01",
"time": "12:00:00"
}
},
"approved": {
"utc": "string_value",
"local": {
"date": "2025-01-01",
"time": "12:00:00"
}
},
"paid": {
"utc": "string_value",
"local": {
"date": "2025-01-01",
"time": "12:00:00"
}
},
"canceled": {
"utc": "string_value",
"local": {
"date": "2025-01-01",
"time": "12:00:00"
}
}
},
"template": {
"id": 123,
"name": "Sample Name"
},
"invoice": {
"id": "string_value"
},
"integration": {
"id": "string_value",
"name": "Sample Name",
"href": "string_value"
},
"integrations": {
"result": []
},
"contacts": {
"metadata": {
"total": 100,
"page": 0,
"pages": 5,
"per_page": 20
},
"results": [],
"correlation_id": "string_value",
"actions": []
},
"tasks": {
"metadata": {
"total": 100,
"page": 0,
"pages": 5,
"per_page": 20,
"completed": {
"confirmassignment": 0,
"c9": 0,
"picture": 0,
"checkin": 0,
"email": 0,
"shipmenttracking": 0,
"other": 0,
"phone": 0,
"download": 0,
"customfield": 0,
"signature": 0,
"checkout": 0,
"closeoutnotes": 0
}
},
"results": [],
"correlation_id": "string_value",
"actions": []
},
"swaps": {
"metadata": {
"total": 100,
"page": 0,
"pages": 5,
"per_page": 20
},
"actions": [],
"results": [],
"correlation_id": "string_value"
},
"equipments": [],
"type_of_work": {
"id": 123,
"name": "Sample Name"
},
"types_of_work": [],
"service_types": [],
"service_types_new": [],
"site_device": [],
"description": {
"html": "string_value",
"markdown": "string_value"
},
"confidential": {
"html": "string_value",
"markdown": "string_value"
},
"policy_and_procedures": {
"html": "string_value",
"markdown": "string_value"
},
"standard_instructions": {
"html": "string_value",
"markdown": "string_value"
},
"progress": {
"sum": {
"all": 0,
"complete": 0,
"incomplete": 0
},
"label": "string_value"
},
"tags": {
"metadata": {
"total": 100,
"page": 0,
"pages": 5,
"per_page": 20
},
"actions": [],
"results": [],
"correlation_id": "string_value"
},
"tasks_enabled": true,
"closing_notes": "string_value",
"allow_counter_offers": true,
"is_user_declined": true,
"w2": true,
"import_id": 0,
"printable": true,
"require_registered_service_companies": true,
"advanced_qualifications": true,
"require_gps": true,
"site_revisit": {
"job_status": "string_value",
"revisit_count": 0,
"is_revisit": true,
"incomplete_reason": {
"reason_id": 0,
"reason_name": "string_value"
}
},
"incident_id": "string_value"
}{
"status": 500,
"message": "Operation successful."
}{
"status": 500,
"message": "Operation successful."
}application/json
application/json
application/json
Last updated on
ID of the incident
I D Dto
I D Dto
ID of the default template
Whether the work order is a universal template
I D Dto
I D Dto
I D Dto
Wo Network Result Dto
Whether the work order is printable
Whether counter offers are allowed
Whether GPS is required
Site Revisit
Service types
Equipment information
I D Dto
Contacts Result Dto
Wo Html Dto
Wo Html Dto
Wo Tasks Result Dto
Wo Custom Fields Result Dto
Wo Location Dto
Work Order Schedule Dto
Whether on-time arrival is required
Wo Pay Dto
Shipment Result Dto
Work Order Ids Dto
Smart audit rule ID
Whether to ignore the template
Whether qualifications are enabled
Types of work
Title of the work order
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": "site",
"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"
}
}'