---

Automatic protection

Some providers closely monitor IP addresses used to access their services. If too many accounts connect from the same IP (e.g., Unipile’s servers), it may raise flags or trigger security measures.

To prevent this, Unipile automatically assigns proxies to accounts for certain sensitive providers. This helps distribute traffic and reduce the risk of accounts being flagged.

By default, Unipile pick a proxy located in a country near the user's IP if it's available, but you can choose a specific country or infer from a specific IP if needed. See Custom country for automatic proxies section below.

Automatic proxy protection is only enabled for providers that require it, currently:

• LinkedIn
• WhatsApp
• Instagram

For other providers, automatic protection is not necessary because they do not restrict access based on IP reuse.

In the dashboard, the proxy is shown as "Auto [COUNTRY]" in the list of Accounts.

---

Use a custom proxy

When linking an account, you can provide your own proxy configuration. We call this a custom proxy, as opposed to the automatic proxy assigned by Unipile.

Which proxy is applied follows a strict load order: the first match in the list is used, and the lookup stops there.

When using Hosted Auth with Create Auth Link

1. Proxy entered by the user (if config.global.allow_user_proxy_override is true).
2. Proxy explicitly set in config.{provider}.custom_proxy.
3. Automatic proxy (if enabled for the provider).

When using Custom Auth with Start Auth Intent

1. Proxy explicitly set in config.custom_proxy.
2. Automatic proxy (if enabled for the provider).

Handling errors

If the given custom proxy (Not automatic proxy) fails to forward requests to the provider:

• The Account status will switch to 🔴 Service Interruption
• A Webhook event account.status.errored will be triggered, with the reason set to proxy.

Unipile will automatically retry requests until the proxy works again. However, you can manually provide a new proxy to restart the account connection immediately. See Update a proxy section below.

---

Custom country for automatic proxies

When an automatic proxy is assigned, Unipile determines its country using the following lookup order. The first matching value stops the resolution.

When using Hosted Auth with Create Auth Link

1. Country chosen by the user (if config.global.allow_user_country_override is true).
2. Country inferred from the IP set in config.{provider}.auto_proxy_config.ip.
3. Country explicitly set in config.{provider}.auto_proxy_config.country.
4. Country inferred from the user’s own IP (default).

When using Custom Auth with Start Auth Intent

1. Country inferred from the IP set in config.auto_proxy_config.ip.
2. Country explicitly set in config.auto_proxy_config.country.
3. Country inferred from the request’s IP (default).

---

Strict proxy country

By default, if the currently selected proxy encounters an issue, Unipile will try to assign another proxy from the same country. If no proxy is available in that country, Unipile will fall back to the best available proxy, which may be located in another region.

If you want an account to use proxies exclusively from its configured country, set allow_country_fallback to false when linking the account using Create Auth Link or Start Auth Intent. You can also update this setting later using Update an Account.

When allow_country_fallback is set to false:

• During authentication, an error will be returned if no proxy is available in the configured country, instead of falling back to a proxy in another country.
• While the account is running, if its current proxy becomes unavailable and no other proxy is available in the configured country, the account will enter a service interruption state (errored status with reason: proxy) instead of switching to a proxy in another country.

---

Update a proxy

To manage the proxy configuration of an Account, use the Update an Account API endpoint.

You can:

• Set or update a custom proxy for an Account.
• Replace automatic protection with a custom proxy.
• Remove a custom proxy — for providers with automatic protection, this will revert the Account to using Unipile’s automatic proxy. In this case, Unipile will assign the best available proxy at that moment, which may come from any region.
• Change the country used by Automatic Proxy Protection with auto_proxy_country. This immediately selects a new automatic proxy in that country when one is available.

Note: You cannot remove the proxy entirely if automatic protection is required for the provider.

---

Countries

Here is the list of all available countries. During account authentication, if the country you explicitly selected, or the country inferred from the IP address, is not included in this list, the best available proxy will be assigned. This proxy may be located in any of the countries listed below.