Create a work order

Adds a new work order at a unit, building or rentable item.

POST https://cotlet.dev/api/v1/resman/properties/{property_id}/work-orders

write Confirm

Returns the new work order id and its number. The work order shows in ResMan at once, and a resident who reported it can follow its progress. ResMan sets the due date from your account settings when you give none. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: create_work_order
NameTypeDescription
property_id string required string Property id from list_properties.
description string required string What is wrong, up to 248 characters.
category_id string required string Category id from list_work_order_options.
location_type string required string Unit, Building, Rentable Item or WOIT Account.
location string required string Unit number, building name or the id of the location.
reported_by string string Name of the resident who reported it.
assigned_to_person_id string string Person id of a maintenance employee.
priority string string Low, Medium or High.
areas array array Impacted areas from list_work_order_options.
notes string string Longer notes for the technician.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/resman/properties/f308c33b-5865-4f7e-97af-46d35f19eddf/work-orders \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"description":"Kitchen faucet leaks under the sink","category_id":"1bb554a6-0b21-4690-83f2-b5650dadcf5e","location_type":"Unit","location":"201","reported_by":"Dana Whitfield","priority":"Medium"}'
Python
result = client.call("resman", "create_work_order", {"property_id":"f308c33b-5865-4f7e-97af-46d35f19eddf","description":"Kitchen faucet leaks under the sink","category_id":"1bb554a6-0b21-4690-83f2-b5650dadcf5e","location_type":"Unit","location":"201","reported_by":"Dana Whitfield","priority":"Medium"})
Node.js
const result = await cotlet.call('resman', 'create_work_order', {"property_id":"f308c33b-5865-4f7e-97af-46d35f19eddf","description":"Kitchen faucet leaks under the sink","category_id":"1bb554a6-0b21-4690-83f2-b5650dadcf5e","location_type":"Unit","location":"201","reported_by":"Dana Whitfield","priority":"Medium"});
CLI
cotlet call resman create_work_order --data '{"property_id":"f308c33b-5865-4f7e-97af-46d35f19eddf","description":"Kitchen faucet leaks under the sink","category_id":"1bb554a6-0b21-4690-83f2-b5650dadcf5e","location_type":"Unit","location":"201","reported_by":"Dana Whitfield","priority":"Medium"}'

Example response

JSON

{
  "work_order_id": "a68ce6b2-a9ef-4127-bf97-067e9f4a548c",
  "number": 1009,
  "property_id": "f308c33b-5865-4f7e-97af-46d35f19eddf"
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.