--- title: phone.stop | Doing Work API description: Put a customer's number on the shop's stop list, for example when they asked out loud not to be texted or called. Stops every text and AI call from the shop. url: https://doingwork.work/docs/reference/phone-stop/ --- # phone.stop Put a customer's number on the shop's stop list, for example when they asked out loud not to be texted or called. Stops every text and AI call from the shop and revokes consent. | | | |---|---| | Who | Agents can call this | | REST | `POST /v1/phone/stop` | | MCP tool | `phone_stop` | | Writes | yes, send an Idempotency-Key | | Area | [Shop](https://doingwork.work/docs/reference/#shop) | ## When to use it Put a customer's number on the shop's stop list, for example when they asked out loud not to be texted or called. Stops every text and AI call from the shop and revokes consent. ## What to tell the owner Say what you did in plain words and what happens next. ## Input | Field | Type | Required | |---|---|---| | `shop_id` | string (uuid) | yes | | `phone` | string | yes | | `note` | string | no | ## Example ```http POST https://doingwork.work/v1/phone/stop content-type: application/json Idempotency-Key: 3f1c... { "shop_id": "00000000-0000-4000-8000-000000000000", "phone": "..." } ``` ## 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/). |