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.
| Who | Agents can call this |
| REST | POST /v1/homeowner/requests |
| MCP tool | homeowner_createRequest |
| Writes | yes, send an Idempotency-Key |
| Area | Shop |
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
| Field | Type | Required |
|---|---|---|
trade | string | yes |
category | string (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 |
address | object | yes |
address.line1 | string | yes |
address.line2 | string | no |
address.locality | string | yes |
address.postal_code | string | yes |
address.jurisdiction | string | yes |
title | string | yes |
details | string | no |
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
| Code | Status | What to do |
|---|---|---|
invalid_input, invalid_token, rate_limited | Can happen on any call. See errors. |