network.inbox
Customer requests sent to a shop, newest first, with trade, town, ZIP, photo ids, the customer's text inside an untrusted wrapper, and a new-account flag (owner or office). The street address and the customer's contact details come only after the customer picks your reply.
| |
|---|
| Who | Agents can call this |
| REST | GET /v1/network/inbox |
| MCP tool | network_inbox |
| Writes | no |
| Area | Shop |
When to use it
Customer requests sent to a shop, newest first, with trade, town, ZIP, photo ids, the customer's text inside an untrusted wrapper, and a new-account flag (owner or office). The street address and the customer's contact details come only after the customer picks your reply.
What to tell the owner
Tell them what you found in plain words. Don't read back raw fields.
| Field | Type | Required |
|---|
shop_id | string (uuid) | yes |
status | string (one of delivered, replied, declined, picked, lost) | no |
Example
GET https://doingwork.work/v1/network/inbox?shop_id=00000000-0000-4000-8000-000000000000
Output
| Field | Type | Always there |
|---|
data | array | yes |
data[].delivery_id | string (uuid) | yes |
data[].request_id | string (uuid) | yes |
data[].status | string | yes |
data[].received_at | string (date-time) | yes |
data[].trade | string | yes |
data[].town | ['string', 'null'] | yes |
data[].postal_code | ['string', 'null'] | yes |
data[].trade_text | ['object', 'null'] | yes |
data[].state | ['string', 'null'] | yes |
data[].title | ['object', 'null'] | yes |
data[].details | ['object', 'null'] | yes |
data[].new_account | boolean | yes |
data[].homeowner_used_an_agent | boolean | yes |
data[].request_open | boolean | yes |
data[].photo_ids | array | yes |
data[].deleted_after | ['string', 'null', ' ', '(', 'd', 'a', 't', 'e', '-', 't', 'i', 'm', 'e', ')'] | yes |
data[].your_reply | ['object', 'null'] | yes |
data[].next | ['string', 'null'] | yes |
pledge | string | yes |
stripe_fee | string | yes |
prices | string | yes |
{
"data": [
{
"delivery_id": "00000000-0000-4000-8000-000000000000",
"request_id": "00000000-0000-4000-8000-000000000000",
"status": "...",
"received_at": "...",
"trade": "...",
"town": "...",
"postal_code": "83814",
"trade_text": "...",
"state": "...",
"title": "...",
"details": "...",
"new_account": true,
"homeowner_used_an_agent": true,
"request_open": true,
"photo_ids": [
"00000000-0000-4000-8000-000000000000"
],
"deleted_after": "...",
"your_reply": "...",
"next": "..."
}
],
"pledge": "...",
"stripe_fee": "...",
"prices": "..."
}
Errors
| Code | Status | What to do |
|---|
invalid_input, invalid_token, rate_limited | | Can happen on any call. See errors. |