---
title: Map ACL to Trunk (Whitelist IP)
slug: dynamic-sip-trunking/map-acl-to-trunk-whitelist-ip
createdAt: 2026-08-10T10:41:08.724Z
---

Registers your server's public IP address for authentication. This is required for **Outbound/Termination** calls - allowing your system to send calls through the trunk.

ACL (Access Control List) ensures only authorized IP addresses can use your trunk for outbound calling.

### HTTP Request

:::BlockQuote
POST https\://\<your\_api\_key>:\<your\_api\_token>@\<subdomain>/v2/accounts/\<your\_sid>/trunks/\<trunk\_sid>/whitelisted-ips
:::

### Request Headers

| Header       | Value            |
| ------------ | ---------------- |
| Content-Type | application/json |

### Request Parameters

| Parameter Name | Mandatory/Optional | Value                                                                                                                  |
| -------------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| ip             | Mandatory          | String; Your server's public IP address. Must be a valid IPv4 address. Example: 44.248.146.11, 203.0.113.50            |
| mask           | Optional           | Integer; Subnet mask in CIDR notation. Default: 32(single IP). Use 24for /24 subnet, 16for /16 subnet. Example: 32, 24 |

### Example Request

:::BlockQuote
curl -s -X POST "https\://\<your\_api\_key>:\<your\_api\_token>@\<subdomain>/v2/accounts/\<your\_sid>/trunks/\<trunk\_sid>/whitelisted-ips" \\
&#x20; -H "Content-Type: application/json" \\
&#x20; -d '\{
&#x20;   "ip": "44.248.146.11",
&#x20;   "mask": 32
&#x20; }'
:::

### HTTP Response

On success, the HTTP response status code will be 200 OK.

### Example Response

:::BlockQuote
\{
&#x20; "request\_id": "3daaed4cd05d443f854e07e60dd4c008",
&#x20; "method": "POST",
&#x20; "http\_code": 200,
&#x20; "response": \{
&#x20;   "code": 200,
&#x20;   "error\_data": null,
&#x20;   "status": "success",
&#x20;   "data": \{
&#x20;     "id": "1153",
&#x20;     "mask": 32,
&#x20;     "trunk\_sid": "trmum1f708622631150902801a1n",
&#x20;     "ip": "44.248.146.11",
&#x20;     "friendly\_name": null,
&#x20;     "date\_created": "2026-01-23T11:37:36Z",
&#x20;     "date\_updated": "2026-01-23T11:37:36Z"
&#x20;   }
&#x20; }
}
:::

### Response Parameters

| Parameter Name | Type & Value                                                |
| -------------- | ----------------------------------------------------------- |
| id             | String; Unique identifier for this ACL entry. Example: 1153 |
| ip             | String; The whitelisted IP address                          |
| mask           | Integer; Subnet mask in CIDR notation                       |
| trunk\_sid     | String; The trunk this ACL is associated with               |
| friendly\_name | String or null; Optional friendly name for the IP           |
| date\_created  | String; ISO 8601 timestamp when ACL was created             |
| date\_updated  | String; ISO 8601 timestamp when ACL was last updated        |