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

# Do Not Call list

> Block numbers from being dialed with your account's Do Not Call list and US federal and state registry checks.

Callers can stop an agent from calling numbers that must not be contacted. You can block numbers in two ways:

* **Account Do Not Call list:** your own list of blocked numbers, shared by every agent in the account.
* **US registry checks:** compare numbers with the US Federal Do Not Call registry, and optionally state lists, before calling.

Both are turned on per agent, so you choose which agents enforce them.

> [!WARNING]
>
> You're responsible for complying with the laws that apply to your calls and messages, such as the TCPA, telemarketing rules, and consent requirements in each country you contact. These tools help you enforce your own policy; they don't guarantee compliance on their own. Check with your legal counsel on what your outreach requires. See [Compliance](https://docs.callers.ai/documentation/best-practices/compliance.md#do-not-call) for a practical overview.

## The account Do Not Call list

Go to **Contacts** and open the **Do Not Call List** tab. The tab is available to admins.

The list shows each number with its **Date Added** and **Reason Added**:

| Reason | How the number was added |
| :- | :- |
| **Manually uploaded** | Someone added it by hand or by CSV import. |
| **Asked not to call in a phone call** | A contact asked not to be called during a call, and the agent adds such numbers automatically. |

Use **Search DNC List** to find a number. Hover over a row to remove it.

![Contacts page on the Do Not Call List tab showing a table of phone numbers with their Date Added and Reason Added, a search field, and an Add Phone Numbers button](https://mintcdn.com/voxiaai/UGuY0UNIphM-6pUX/images/documentation/contacts/do-not-call-list.png?fit=max\&auto=format\&n=UGuY0UNIphM-6pUX\&q=85\&s=48eeeb23508e1746e6eceb19384457ba)

The Do Not Call List tab on the Contacts page, with the Add Phone Numbers button.

### Add numbers

Click **Add Phone Numbers**, then choose a tab:

**Add Manually**

Paste or type phone numbers in international format (for example `+15551234567`) and click **Done**.

**Import File**

Upload a CSV file with a `phoneNumber` column. The headers `phone`, `phone_number`, and `number` also work.

```csv dnc.csv theme={"dark"}
phoneNumber
+15551234567
+15559876543
```

Numbers must include the country code. Rows with an empty or invalid number are rejected; open **Import History** and download the error file to see which rows failed.

## Turn on Do Not Call checks for an agent

Open the agent, click **Edit**, and open [**Technical Settings**](https://docs.callers.ai/documentation/build-your-agent/agent-setup.md#technical-settings-voice-agents).

| Setting | What it does |
| :- | :- |
| **Enable Account Do Not Call (DNC) List** | Blocks calls to numbers on your account's Do Not Call list. |
| **Update Account Do Not Call (DNC) List Automatically** | When a contact asks not to be called, adds their number to the account list. Shown when the account list is enabled, and turned on with it. |
| **Check US Federal Do Not Call (DNC) Registry** | Blocks calls to numbers listed on the US Federal Do Not Call registry. Test calls are excluded. |
| **Include State Do Not Call (DNC) Lists** | Also blocks numbers on US state Do Not Call lists. Shown when the federal check is on. |

> [!TIP]
>
> Turn on both account list settings on every outbound agent. A contact who asks one agent to stop calling is then blocked from all your other agents too.

## What happens to a blocked number

Numbers are checked at two points:

1. **At import.** A contact whose number is on the account list (when the agent uses it) or on the registry (when the agent checks it) is rejected. It appears as a failed row in **Import History**, with the reason.
2. **Before each call.** The account list is checked first, then the registry. A match stops the call. The call is marked **Do not call** and so is the contact, and it's not dialed again.

Contacts with [several phone numbers](https://docs.callers.ai/documentation/using-callers/uploading-contacts.md#multiple-phone-numbers-per-contact) are checked before each call rather than at import.

Numbers that match the registry aren't added to your account list.

### Requests during a call

When a contact clearly asks not to be called again ("take me off your list", "never call me again"), the call outcome is **Do not call** and the contact isn't called again by that agent. If **Update Account Do Not Call (DNC) List Automatically** is on, the number is also added to the account list with the reason **Asked not to call in a phone call**. See [Statuses and outcomes](https://docs.callers.ai/documentation/using-callers/call-statuses.md).

## Text message opt-outs

For SMS through [Twilio](https://docs.callers.ai/documentation/text-agents/twilio-sms.md), Callers follows Twilio's opt-out handling. When a contact replies with an opt-out keyword such as STOP, the conversation and contact are marked **Unsubscribed** and the agent stops messaging them. An opt-in keyword such as START subscribes them again. The keywords themselves are set in your Twilio account. Telnyx handles opt-out keywords on its own numbers; see [Telnyx SMS](https://docs.callers.ai/documentation/text-agents/telnyx-sms.md#opt-outs).

The agent also marks a conversation **Unsubscribed** when the contact asks to stop in their own words.

Unsubscribing from text messages doesn't add the number to the Do Not Call list. If a contact who opts out of texts should also not be called, add their number to the list.

## FAQ

> **Do test calls check the registry?**
>
> No. Test calls skip the federal and state registry checks.

> **I removed a number from the list. Will the agent call it again?**
>
> Only if the contact is still eligible. A contact already marked **Do not call** isn't dialed again. Use **Update Status** on the agent to change it if you have consent to call.

> **Does the registry check work for numbers outside the US?**
>
> No. The registry checks cover US federal and state lists only. Use the account Do Not Call list for other countries.

## Related

> **[Statuses and outcomes](https://docs.callers.ai/documentation/using-callers/call-statuses.md)**
>
> How Do not call outcomes are decided.

> **[Add contacts](https://docs.callers.ai/documentation/using-callers/uploading-contacts.md)**
>
> Import contacts and review failed rows.

> **[Guardrails](https://docs.callers.ai/documentation/build-your-agent/instructions-and-guardrails.md)**
>
> Keep agents within your policies during conversations.

> **[Security and privacy](https://docs.callers.ai/documentation/account/security-and-privacy.md)**
>
> Data retention and access controls.


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