Update IP allowlist settings

Request

Update the IP allowlist configuration for the workspace.

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.

Security

bearerAuth

Intercom-Versionstring(intercom_version)

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

Default:"2.14"

Enum:"1.0""1.1""1.2""1.3""1.4""2.0""2.1""2.2""2.3""2.4"

Example:2.14

Bodyapplication/json

typestring

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

Example:"ip_allowlist"

enabledboolean

Whether the IP allowlist is enabled for the workspace.

Example:true

ip_allowlistArray of strings

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:

[
  "192.168.1.0/24",
  "10.0.0.1"
]

curl -i -X PUT \
  https://api.intercom.io/ip_allowlist \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'Intercom-Version: 2.14' \
  -d '{
    "enabled": true,
    "ip_allowlist": [
      "192.168.1.0/24",
      "10.0.0.1"
    ]
  }'

Responses

Successful response