---
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 sho
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/). |