--- title: homeowner.webhookCreate | Doing Work API description: Add a webhook so your own assistant hears about your requests: homeowner.reply_received, homeowner.booking_changed, homeowner.dispute_decided and. url: https://doingwork.work/docs/reference/homeowner-webhookcreate/ --- # 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](https://doingwork.work/docs/reference/#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 ```http 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](https://doingwork.work/docs/errors/). |