homeowner.webhookCreate
Add a webhook so your own assistant hears about your requests: homeowner.reply_received, homeowner.booking_changed, homeowner.dispute_decided and homeowner.request_delivered. The url must be https on a public internet address. Signed the same way as shop webhooks (dw-signature). Returns the signing secret once.
| Who | Agents can call this |
| REST | POST /v1/homeowner/webhooks |
| MCP tool | homeowner_webhookCreate |
| Writes | yes, send an Idempotency-Key |
| Area | Shop |
When to use it
Add a webhook so your own assistant hears about your requests: homeowner.reply_received, homeowner.booking_changed, homeowner.dispute_decided and homeowner.request_delivered. The url must be https on a public internet address.
What to tell the owner
Say what you did in plain words and what happens next.
Input
| Field | Type | Required |
|---|---|---|
url | string | yes |
events | array | no |
Example
POST https://doingwork.work/v1/homeowner/webhooks
content-type: application/json
Idempotency-Key: 3f1c...
{
"url": "https://example.com/hooks/doing-work"
}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. |