Twilio API (unofficial showcase)
POST/2010-04-01/Accounts/{AccountSid}/SIP/IpAccessControlLists/{IpAccessControlListSid}/IpAddresses.json

Create an IP address in an access control list

Creates an IP address resource in an IP access control list. Provide FriendlyName and an IPv4 address in IpAddress; optionally set CidrPrefixLength to specify the address prefix. The prefix defaults to the full address when omitted.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

2 parameters · 3 body fields
AccountSidstringrequired
The account identifier, in the format `AC` followed by 32 hexadecimal characters.
IpAccessControlListSidstringrequired
The IP access control list identifier, in the format `AL` followed by 32 hexadecimal characters.

Form-encoded details for the IP address resource to add to the access control list.

FriendlyNamestringrequired
A human readable descriptive text for this resource, up to 255 characters long.
IpAddressstringrequired
An IP address in dotted decimal notation from which you want to accept traffic. Any SIP requests from this IP address will be allowed by Twilio. IPv4 only supported today.
CidrPrefixLengthintegeroptional
An integer representing the length of the CIDR prefix to use with this IP address when accepting traffic. By default the entire IP address is used.

1 status code
201Returns the created IP address resource, including its identifier, friendly name, IP address, CIDR prefix length, associated list identifier, creation and update dates, and resource URI.
sidstringoptional
A 34 character string that uniquely identifies this resource.
account_sidstringoptional
The unique id of the Account that is responsible for this resource.
friendly_namestringoptional
A human readable descriptive text for this resource, up to 255 characters long.
ip_addressstringoptional
An IP address in dotted decimal notation from which you want to accept traffic. Any SIP requests from this IP address will be allowed by Twilio. IPv4 only supported today.
cidr_prefix_lengthintegeroptional
An integer representing the length of the CIDR prefix to use with this IP address when accepting traffic. By default the entire IP address is used.
Default:0
ip_access_control_list_sidstringoptional
The unique id of the IpAccessControlList resource that includes this resource.
date_createdstringoptional
The date that this resource was created, given as GMT in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format.
date_updatedstringoptional
The date that this resource was last updated, given as GMT in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format.
uristringoptional
The URI for this resource, relative to `https://api.twilio.com`

Error handling

The AccountSid path parameter must be a 34-character account identifier beginning with AC and followed by 32 hexadecimal characters, and IpAccessControlListSid must be a 34-character list identifier beginning with AL and followed by 32 hexadecimal characters. Include both FriendlyName and IpAddress in the body; IpAddress must be an IPv4 address in dotted-decimal notation, as IPv4 is the supported format.