v51

latestOpenAPI 3.0.1MITraw.githubusercontent.com2026-08-01150230854.3 KB

IP Allowlist

Update IP allowlist settings

Update the IP allowlist configuration for the workspace.

{% admonition type="warning" name="Lockout Protection" %} The API will reject updates that would lock out the caller's IP address. Ensure your current IP is included in the allowlist when enabling the feature. {% /admonition %}

put/ip_allowlist

Headers

Intercom-Version'1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14'

Intercom API version.</br>By default, it's equal to the version set in the app package.

Example:2.14

Request body

typestring

String representing the object's type. Always has the value ip_allowlist.

enabledboolean

Whether the IP allowlist is enabled for the workspace.

ip_allowliststring[]

List of allowed IP addresses and/or IP ranges in CIDR notation. Examples:

Single IP: 192.168.0.1
IP range: 192.168.0.1/24 (allows 192.168.0.0 - 192.168.0.255)

Example request

{
  "type": "ip_allowlist",
  "enabled": true,
  "ip_allowlist": [
    "192.168.1.0/24",
    "10.0.0.1"
  ]
}

Response

Successful response