homeowner.createRequest

Start a customer request for quotes for any home-service work at any US address (address is an object, not a string, with required line1, locality, postal_code and jurisdiction (line2 is optional; jurisdiction is an ISO 3166-2 code like US-ID, and a US shop also accepts ID, id, or Idaho), for example {"line1":"100 Test St","locality":"Boise","postal_code":"83702","jurisdiction":"US-ID"}): the trade in your own words, the service address and what you need. Then add photos with homeowner.addPhoto and send it with homeowner.sendRequest. Free; Doing Work never charges lead fees and never sets a price.

WhoAgents can call this
RESTPOST /v1/homeowner/requests
MCP toolhomeowner_createRequest
Writesyes, send an Idempotency-Key
AreaShop

When to use it

Start a customer request for quotes for any home-service work at any US address (address is an object, not a string, with required line1, locality, postal_code and jurisdiction (line2 is optional; jurisdiction is an ISO 3166-2 code like US-ID, and a US shop also accepts ID, id, or Idaho), for example {"line1":"100 Test St","locality":"Boise","postal_code":"83702","jurisdiction":"US-ID"}): the trade in your own words, the service address and what you need. Then add photos with homeowner.addPhoto and send it with homeowner.sendRequest.

What to tell the owner

Say what you did in plain words and what happens next.

Input

FieldTypeRequired
tradestringyes
categorystring (one of painting, fencing, gutters, roofing, siding, windows_doors, plumbing, electrical, hvac, landscaping, lawn_care, tree_service, concrete_masonry, decks_patios, flooring, drywall, carpentry, cabinets_countertops, remodeling, handyman, cleaning, pressure_washing, pest_control, junk_removal, moving, appliance_repair, garage_doors, insulation, foundation, septic, pools, solar, locksmith, other)no
addressobjectyes
address.line1stringyes
address.line2stringno
address.localitystringyes
address.postal_codestringyes
address.jurisdictionstringyes
titlestringyes
detailsstringno

Example

POST https://doingwork.work/v1/homeowner/requests
content-type: application/json
Idempotency-Key: 3f1c...

{
  "trade": "...",
  "address": {
    "line1": "412 Elm St",
    "locality": "Coeur d'Alene",
    "postal_code": "83814",
    "jurisdiction": "US-ID"
  },
  "title": "..."
}

Output

JSON. The response shape isn't published yet; read the fields you need and ignore the rest. Errors are {code, message, status}.

Errors

CodeStatusWhat to do
invalid_input, invalid_token, rate_limitedCan happen on any call. See errors.