> For the complete documentation index, see [llms.txt](https://docs.voiceb.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.voiceb.ai/allowed-countries-control-where-your-agents-can-call.md).

# Allowed Countries: Control Where Your Agents Can Call

How to enable the countries your account and each campaign may call, to prevent unwanted calls and keep costs under control.

By Alex Bisbe. Last update: October 2026

VoiceB lets you decide **which countries your agents are allowed to call**. Any call to a country that is not on the list is **blocked before it is placed**, so it never reaches the carrier and is never billed.

You configure this in two places, and both need to be set up for a campaign to place calls to a country:

1. **Account level:** the countries your organization may use at all.
2. **Campaign level:** the countries each individual campaign may call, chosen from the account list.

***

### Why this matters

* **Security.** Without a country restriction, anyone who gets access to a widget, click-to-call endpoint or campaign could trigger calls to any destination. Limiting each campaign to the countries you really sell in closes that door.
* **Cost control.** Calls to some destinations are very expensive. A short allowlist keeps unwanted or fraudulent traffic from ever generating charges.
* **Compliance and focus.** Your campaigns only reach the markets you actually operate in.

***

### Step 1: Enable countries at account level

An organization admin sets the full list of countries your account may use.

{% stepper %}
{% step %}

#### Open Settings

In the left menu, click **Settings**.
{% endstep %}

{% step %}

#### Scroll down to Enabled countries

At the bottom of the page you will find **Enabled countries**. These are the countries your organization may enable for its campaigns.
{% endstep %}

{% step %}

#### Add your countries one by one

Click the field and select each country you need. Remove any you don't want by clicking the **x** next to its name.
{% endstep %}

{% step %}

#### Save

Click **Save enabled countries**.
{% endstep %}
{% endstepper %}

<figure><img src="https://2950912279-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FggIr2RvhGm49D4vbjurT%2Fuploads%2FHkmUg17aA2Z5yfjaghv4%2FScreenshot%202026-10-28%20at%2013.21.18.png?alt=media&amp;token=deca0c35-a2ad-4d4c-9135-e6626957515b" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Removing a country at account level also **removes it from every campaign** in your organization.
{% endhint %}

***

### Step 2: Allow countries on each campaign

Once the account list is ready, repeat the process **for every campaign**. A campaign can only choose from the countries enabled at account level.

{% stepper %}
{% step %}

#### Open the campaign configuration

Select your campaign and click **Config** in the campaign menu.
{% endstep %}

{% step %}

#### Scroll down to Allowed Countries

The **Allowed Countries** field shows the only countries this campaign may call. Calls to any other country are blocked.
{% endstep %}

{% step %}

#### Add the countries one by one

Open the dropdown and tick each country you want to allow. Untick (or click the **x**) to remove one.
{% endstep %}

{% step %}

#### Save

Click **Save countries**. You can review who changed the list and when in **Change history**, just below.
{% endstep %}
{% endstepper %}

<figure><img src="https://2950912279-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FggIr2RvhGm49D4vbjurT%2Fuploads%2FjdZvueFnlhfkVy6hxTB9%2FScreenshot%202026-10-28%20at%2013.22.12.png?alt=media&amp;token=d3e553c5-09bc-4fe2-9984-61d882aecad6" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2950912279-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FggIr2RvhGm49D4vbjurT%2Fuploads%2FtuoNHYxtS9NxkLpyhKFM%2FScreenshot%202026-10-28%20at%2013.22.22.png?alt=media&amp;token=11d96f18-6272-4b8f-97e1-13501bd6373c" alt=""><figcaption></figcaption></figure>

***

### Good to know

* **Both lists must match.** If a country is missing at account level you cannot select it on the campaign. If it is missing on the campaign, calls to it are blocked even if the account allows it.
* **It applies to every way of calling.** Outbound campaigns, retries, click-to-call (API) and the web widget all follow the campaign's country list.
* **Country is checked on the real destination, not just the prefix.** For example, a `+1` number is not automatically the United States: Canada, Jamaica, the Dominican Republic and other destinations share that prefix. If you allow only the United States, calls to those other countries are blocked.
* **Removing a country stops active calls.** If calls to that country are in progress when you save, they are ended shortly afterwards.
* **Blocked attempts are recorded**, so unusual activity can be detected.

***

### Troubleshooting

| Symptom                                         | What to check                                                                                                  |
| ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| A lead is never called                          | Is the lead's country enabled in **Settings → Enabled countries** and in the campaign's **Allowed Countries**? |
| I can't find a country in the campaign dropdown | Add it first at account level in **Settings**, then return to the campaign.                                    |
| A country disappeared from my campaigns         | It was removed at account level, which also removes it from all campaigns.                                     |

Need help? Contact your VoiceB onboarding engineer or <support@voiceb.ai>.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.voiceb.ai/allowed-countries-control-where-your-agents-can-call.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
