Authorize IP addresses for API calls to improve security

Brevo logs every IP address attempting to make API calls using one of your API keys. This allows you to verify their origin and ensure the call is authorized.

Good to know

Only account owners or users with the SMTP & API - Authorized IPs permission can add an IP address to the list of authorized IP addresses.

Decide how to manage unknown IP addresses when an API call is made

When an API call is made using an unknown IP address, you can choose to manage it in the following ways:

Option 1: Let Brevo automatically review and authorize unknown IP addresses on your behalf [Recommended]

❗️ Important

Once you start using your API keys, Brevo automatically authorizes the IP addresses you use. If no new IPs are detected for 30 days, we’ll automatically activate the Automatic review and authorization of unknown IP addresses option. From that moment on, only previously authorized IPs will be allowed. Any new or unrecognized IPs that Brevo does not trust will be blocked, and you’ll receive an email with details about the IP address and the API key that was used.

account_authorized-IPs_automatic_en-us.png

The fastest and most secure way to protect your API calls is to let Brevo review all IP addresses and automatically approve authorized IP addresses and unknown IP addresses that are considered trustworthy.

If Brevo cannot automatically authorize an unknown IP address, the API call will be blocked, and you will receive an email with the following options:

  • Authorize the unknown IP address.
  • Deny authorization and update the API key.
  • Deactivate the automatic review and blocking to automatically authorize all IP addresses.

Once an IP address is approved, it will be automatically added to your list of authorized IP addresses.

💡 Good to know
IPs automatically authorized by Brevo use a /24 subnet. For example, if the IP address is 192.168.1.25, Brevo will authorize the entire range from 192.168.1.0 to 192.168.1.255 (256 IPs).

Option 2: Manually review and authorize unknown IP addresses

account_authorized-IPs_manual_en-us.png

Another way to protect your API calls is to let Brevo review all IP addresses and automatically approve only authorized ones.

If an IP address cannot be automatically authorized, the API call will be blocked. You can then manually review the IP address and add it to your list of authorized IP addresses if needed.

Option 3: Do not review unknown IP addresses

account_authorized-IPs_deactivate_en-us.png

If you deactivate the review and blocking of IP addresses, any IP address attempting to make API calls using one of your API keys will be accepted automatically

💡 Good to know

Your list of authorized IPs will be saved in case you choose to activate the feature again later.

Manually add an IP address to your list of authorized IP addresses

To prevent trusted IP addresses from being blocked, you can proactively add them to your list of authorized IP addresses. This ensures that any API calls from these addresses won't be blocked and will let Brevo automatically review and authorize unknown IP addresses on your behalf.

  1. Go to your account name and select Security > Authorized IPs.
  2. Click Add authorized IP address.
    account_authorized-IPs_add1_en-us.png
  3. Type the IP address or IP address range you want to authorize.
    💡 Good to know
    An IP address is structured as a sequence of 4 numbers separated by dots, with each number ranging from 0 to 255 (e.g., 118.29.251.24). An IP address range is a group of IP addresses (e.g., 192.168.0/16).
  4. Click Add authorized IP address.
    account_authorized-IPs_add2_en-us.png

The IP address has been added to your list of authorized IP addresses.

Manually remove an IP address from your list of authorized IP addresses

When an IP address is authorized, it is added to your list of authorized IP addresses. If needed, you can also manually remove an IP address.

  1. Go to your account name and select Security > Authorized IPs.
  2. Select the IP address you want to remove. 
  3. Click Delete this authorized IP address.
    account_authorized-IPs_delete_en-us.png
  4. Click Delete IP address.

The IP address has been removed and cannot be used to make API calls anymore.

❗️ Important
If you let Brevo automatically review and authorize unknown IP addresses on your behalf, an IP address you previously removed may be re-authorized if it is used for another API call and deemed trustworthy.

🤔 Have a question?

If you have a question, feel free to contact our support team by creating a ticket from your account. If you don't have an account yet, you can contact us here.

If you’re looking for help with a project using Brevo, we can match you with the right certified Brevo Agency partner.

💬 Was this article helpful?

12 out of 27 found this helpful