---
title: Denylist
description: How to manage the phone number denylist for survey campaigns.
---

The Denylist is a global list of phone numbers that must not be contacted in survey campaigns. When a number is on the denylist, it is automatically excluded from outgoing calls regardless of which recipient list or campaign it appears in.

Common reasons a number ends up on the denylist include a recipient requesting removal during a call, a rejected call, or a manual decision by an operator.

Navigate to [**Surveys → Denylist**]({APP_HOST}/surveys/denylist/phone-numbers).

---

## Denylist entries

Each entry stores the following information:

| Field | Description |
|---|---|
| **Phone number** | The blocked phone number in international format (e.g. `+36301234567`). |
| **Added at** | The date and time the entry was created. |
| **Reason** | An optional note explaining why the number was added. |
| **Removal request sources** | Campaigns that triggered an automatic removal request for this number, with the timestamp of each request. |

---

## Adding an entry manually

Click **Add** in the toolbar and fill in:

- **Phone number** – the number to block, in international format.
- **Reason** *(optional)* – a short note explaining why the number is being blocked.

Click **Add** to save the entry.

---

## Editing an entry

Click the **Edit** (pencil) icon on any row to open the edit dialog. You can update the **Reason** field. The phone number itself cannot be changed; to correct a number, delete the entry and add a new one.

---

## Deleting entries

### Deleting a single entry

Click the **Delete** (trash) icon on the entry row and confirm the prompt.

### Deleting multiple entries

Select entries using the checkboxes, then click **Delete (n)** in the selection toolbar that appears. Use **Select all** to extend the selection to all currently visible entries. Click **Clear selection** to deselect without deleting.

### Clearing the entire denylist

When the denylist contains more than one entry, a **Clear** button appears in the toolbar. Clicking it removes all entries at once after confirmation. This action cannot be undone.

---

## Searching and sorting

When the denylist contains more than one entry, a **Search** box appears in the toolbar. It filters the list in real time by phone number.

Click a column header to sort the list:

- **Phone number** – alphabetical ascending order.
- **Added at** – chronological descending order (most recently added first).

---

## Importing from CSV

Click **Import** to bulk-upload entries from one or more CSV files.

### CSV format

The file must use **UTF-8** encoding. Supported columns:

| Column | Description |
|---|---|
| `PhoneNumber` | Phone number in international format. Required. |
| `Reason` | Reason for blocking the number. Optional. |

Example:

| PhoneNumber | Reason |
|---|---|
| +36301234567 | Rejected call |
| +36707654321 | Requested removal |
| +36201122334 | |

### Import options

| Option | Description |
|---|---|
| **Delimiter** | The character used to separate columns in the CSV file (comma, semicolon, tab, etc.). |
| **Reason column handling** | Controls what happens when an imported number already exists on the denylist: **Merge** appends the new reason to the existing one; **Overwrite** replaces it. |

---

## Exporting the denylist

When the denylist contains at least one entry, an **Export** button appears in the toolbar. Clicking it downloads the full list as a UTF-8 CSV file with the following columns: `PhoneNumber`, `AddedAt`, `Reason`.

The file is named `phone-number-denylist-<timestamp>.csv`.

---

## Applying the denylist to a recipient list

You can remove all denylisted numbers from a [recipient list](./recipients) in two ways:

- **Denylist operation** – open the recipient list, click **Operations**, and run the **Denylist** reduction. This permanently removes all recipients whose phone numbers appear on the denylist from that list.
- **Denylist removal during CSV import** – when importing recipients, enable the **Denylist removal** option to automatically remove the imported contacts from the denylist, making them contactable again.