Allowlist your IP addresses

The IP allowlist is a list of the internet addresses your servers call Bridge from. If someone steals your API key, they still can’t use it from anywhere else.

The list starts empty, and an empty list blocks every request. You must add at least one address before your API key will work.

Add an address

Open the integration settings

Go to Settings → Integration → IP whitelisting.

Add the address

Choose Add IP address. Enter the address and a label so you remember what it is, for example app-production.

Save

The change takes effect straight away.

What you can add

Type	Example
A single IPv4 address	`203.0.113.10`
A single IPv6 address	`2001:db8::10`
A range of addresses (CIDR)	`203.0.113.0/24`

You can add up to 5 entries.
Labels can be up to 64 characters.
203.0.113.10 and 203.0.113.10/32 are the same entry, so you can’t add both.

If your servers’ addresses change often, ask your hosting provider for a fixed outgoing address (sometimes called a static IP or NAT gateway).

When a request is blocked

A blocked request gets a 403 error. The message tells you which address the request came from, so you know exactly what to add.

No addresses added yet
Address not on the list

{
  "error": {
    "type": "authorization_error",
    "code": "forbidden",
    "message": "No IP addresses are allowlisted for this business. This request came from 198.51.100.7. Add the addresses that call the API in the dashboard.",
    "request_id": "req_3VnR7tY1wZ4cB6dE8fK2mQ9xLp",
    "status": 403
  }
}

{
  "error": {
    "type": "authorization_error",
    "code": "forbidden",
    "message": "This IP address is not allowed to call the API. This request came from 198.51.100.7. Add it to the allowlist in the dashboard if it should have access.",
    "request_id": "req_3VnR7tY1wZ4cB6dE8fK2mQ9xLp",
    "status": 403
  }
}

Add that address, or check that your server is calling from the address you expected.

Last modified on October 29, 2026

Get started

Set up your account

Before you build

Core flows

Webhooks

Errors

Allowlist your IP addresses

Add an address

What you can add

When a request is blocked

​Add an address

​What you can add

​When a request is blocked

Add an address

What you can add

When a request is blocked