> ## Documentation Index
> Fetch the complete documentation index at: https://docs.60db.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Do-Not-Call Number

> Add a number to the do-not-call list. Campaigns skip it from then on

Add a number to the do-not-call list. Campaigns already running skip the number the next time a call is due. Adding a number that is already listed returns the existing entry, with its first `reason`.

## Request

### Headers

**Authorization** `string` *required*

Bearer token with your API key (scope `agents`)

**Content-Type** `string` *required*

application/json

### Body

**phone** `string` *required*

An international number, for example `+919876543210`. Numbers without `+` or `00` are refused. 5 to 32 characters

**reason** `string`

Why the number is listed. Up to 200 characters

## Response

**201 Created** with the entry.

```json theme={null}
{
  "success": true,
  "data": {
    "id": "5a0e7c31-9d2b-4e6f-8a1c-3b4d5e6f7a8b",
    "phone": "+919876543210",
    "reason": "Asked not to be called",
    "created_at": "2026-11-12T10:00:00.000Z"
  }
}
```

## Errors

| Status | Code | Meaning |
| - | - | - |
| 400 | `VALIDATION_ERROR` | `phone` is missing, too short or too long, or is not an international number. `field` is `phone` |
| 403 | `POLICY_DENY` | Your role cannot control campaigns, or the API key lacks the `agents` scope |

## Example

```bash cURL theme={null}
curl -X POST https://api.60db.ai/agents/do-not-call \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"phone": "+919876543210", "reason": "Asked not to be called"}'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.