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

# Blacklist a Number

> Block unwanted calls by managing blacklisted phone numbers in CloudTalk

<Note>
  CloudTalk allows you to create a blacklist of phone numbers to block unwanted calls. In this article, you’ll learn how to add, edit, and remove blacklisted numbers, as well as how to manage them using the CloudTalk API.
</Note>

**User level:** Admin

***

<h2 id="h_a98ac7deb2">
  Blacklist phone numbers in CloudTalk
</h2>

You can add phone numbers to your **Blacklist** to prevent unwanted calls. This is useful if you regularly receive calls from:

* Bots

* Annoying vendors

* Persistent telemarketers

* Spam callers

Once a number is blacklisted, CloudTalk will automatically block it based on your chosen call direction.

<h2 id="h_cd12f97e59">
  How to add a number to the blacklist
</h2>

1. In the **Dashboard**, go to **Account > Settings > Blacklist**.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2145423/c6481d174c07-screenshot-2b2024-12-10-2bat-2b16-20-47.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=753440f9d80e50bd253e2cf5c5cb6384" alt="" width="2090" height="350" data-path="images/help-center/articles/2145423/c6481d174c07-screenshot-2b2024-12-10-2bat-2b16-20-47.png" />
</Frame>

2\. Click **`+ Add number`** in the top-left corner.

3\. In the **Add blocked number** panel:

* Select the **Country prefix**.

* Enter the **Phone number to block** in its basic format (for example, `949111222`).

* Choose the **Call type**:

  * Inbound calls

  * Outbound calls

  * Both inbound and outbound calls

<Frame>
  <img src="https://mintcdn.com/cloudtalk/NaLCtq06pFIW2ogE/images/help-center/articles/2145423/53a50bad725d-screenshot-2024-12-10-at-16-18-17.png?fit=max&auto=format&n=NaLCtq06pFIW2ogE&q=85&s=f610fb7f9d4b63317556ef2606086c54" alt="" width="2049" height="855" data-path="images/help-center/articles/2145423/53a50bad725d-screenshot-2024-12-10-at-16-18-17.png" />
</Frame>

4\. Click **`Add number`**.

There is currently **no limit** to the number of phone numbers you can add to your blacklist.

<Info>
  You can later **edit** a blacklisted number by clicking the **edit (pencil) icon** next to it and updating the country prefix, phone number, or call type.
</Info>

<h2 id="h_15aa7b298b">
  Managing the Blacklist via API (advanced)
</h2>

For teams that prefer automation or need to manage the Blacklist at scale, CloudTalk also allows you to maintain blacklisted numbers through the **CloudTalk API**.

Using the **Blacklist API**, you can:

* View all blacklisted numbers

* Add new numbers

* Update existing blacklist rules

* Remove numbers from the blacklist

You can find detailed information about these API endpoints in our [API documentation.](/developers#tag/Other/paths/~1blacklist~1index.json/get)

<Warning>
  **Tip:** By using a combination of the API **[Add number to blacklist](/developers#tag/Other/paths/~1blacklist~1add.json/put)** endpoint and CloudTalk’s **Workflow Automation** feature, you can automatically blacklist numbers based on call results.

  A common example is when a campaign call ends with a call disposition such as **"Do not call again"**. In this case, the workflow can automatically add the caller’s number to the blacklist without any manual action.

  This setup is especially useful for outbound campaigns and compliance-driven workflows.

  👉 Learn more about **Workflow Automations** [here](/en/articles/5450779-configuring-workflow-automations).
</Warning>

<h2 id="h_5181dc1b6d">
  How to remove a number from the Blacklist
</h2>

In **Account > Settings > Blacklist,** find the number you want to remove, click the **delete (trash) icon** on the right, and confirm the action.

The number is removed from the blacklist immediately.

***

*Need help or have a question?* Just reach out through our [Support portal](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — we’re here for you.


## Related topics

- [Account Settings Guide](/en/articles/10550593-account-settings-guide.md)
- [Add number to blacklist](/api-reference/utilities/add-number-to-blacklist.md)
- [Delete number from blacklist](/api-reference/utilities/delete-number-from-blacklist.md)


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