--- title: hub.requestWork | Doing Work API description: From the customer hub, ask the shop for new work. It lands in the shop's requests (source portal) on this customer, with their contact details already. url: https://doingwork.work/docs/reference/hub-requestwork/ --- # hub.requestWork From the customer hub, ask the shop for new work. It lands in the shop's requests (source portal) on this customer, with their contact details already filled. Up to 5 a day. Hosted page only. | | | |---|---| | Who | Hosted page only (a person does it in the browser) | | REST | `POST /v1/hub/requestWork` | | MCP tool | Not an MCP tool | | Writes | yes, send an Idempotency-Key | | Area | [Customer hub, requests and customer emails](https://doingwork.work/docs/reference/#customer-hub-requests-and-customer-emails) | ## When to use it From the customer hub, ask the shop for new work. It lands in the shop's requests (source portal) on this customer, with their contact details already filled. ## What to tell the owner Send the person the link. They finish this step themselves on the page; you never do it for them. ## Input | Field | Type | Required | |---|---|---| | `k` | string | yes | | `title` | string | yes | | `details` | string | no | | `preferred_times` | string | no | | `property_id` | string (uuid) | no | ## Example ```http POST https://doingwork.work/v1/hub/requestWork content-type: application/json Idempotency-Key: 3f1c... { "k": "...", "title": "..." } ``` ## Output | Field | Type | Always there | |---|---|---| | `request_id` | string (uuid) | yes | ```json { "request_id": "00000000-0000-4000-8000-000000000000" } ``` ## Errors | Code | Status | What to do | |---|---|---| | `invalid_input`, `invalid_token`, `rate_limited` | | Can happen on any call. See [errors](https://doingwork.work/docs/errors/). |