Create ip record

POST /v1/IpRecords
Account sid auth token

IP Records hold information about the IP addresses and ranges (CIDR blocks) that your traffic will be associated with.

application/x-www-form-urlencoded

Body

  • IpAddress string Required

    An IP address in dotted decimal notation, IPv4 only.

  • FriendlyName string

    A descriptive string that you create to describe the resource. It is not unique and can be up to 255 characters long.

  • CidrPrefixLength integer

    An integer representing the length of the CIDR prefix to use with this IP address. By default the entire IP address is used, which for IPv4 is value 32.

Responses

  • 201 application/json

    Created

    Hide headers attributes Show headers attributes
    • Access-Control-Allow-Origin string

      Specify the origin(s) allowed to access the resource

    • Access-Control-Allow-Methods string

      Specify the HTTP methods allowed when accessing the resource

    • Access-Control-Allow-Headers string

      Specify the headers allowed when accessing the resource

    • Access-Control-Allow-Credentials boolean

      Indicates whether the browser should include credentials

    • Access-Control-Expose-Headers string

      Headers exposed to the client

    Hide response attributes Show response attributes object
    • account_sid string | null

      The SID of the Account that created the IP Record resource.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.

    • sid string | null

      The unique string that we created to identify the IP Record resource.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^IL[0-9a-fA-F]{32}$.

    • friendly_name string | null

      The string that you assigned to describe the resource.

    • ip_address string | null

      An IP address in dotted decimal notation, IPv4 only.

    • cidr_prefix_length integer

      An integer representing the length of the CIDR prefix to use with this IP address. By default the entire IP address is used, which for IPv4 is value 32.

      Default value is 0.

    • date_created string(date-time) | null

      The date and time in GMT that the resource was created specified in RFC 2822 format.

    • date_updated string(date-time) | null

      The date and time in GMT that the resource was last updated specified in RFC 2822 format.

    • url string(uri) | null

      The absolute URL of the resource.
POST /v1/IpRecords 
curl \
 --request POST 'https://voice.twilio.com/v1/IpRecords' \
 --user "username:password" \
 --header "Content-Type: application/x-www-form-urlencoded" \
 --data 'IpAddress=10.2.3.4&FriendlyName=friendly_name&CidrPrefixLength=30'
Request example 
{"IpAddress"=>"10.2.3.4", "FriendlyName"=>"friendly_name", "CidrPrefixLength"=>30}
Response examples (201) 
{
  "sid": "ILaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "url": "https://voice.twilio.com/v1/IpRecords/ILaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "ip_address": "10.2.3.4",
  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "date_created": "2020-03-18T23:31:36Z",
  "date_updated": "2020-03-18T23:31:36Z",
  "friendly_name": "friendly_name",
  "cidr_prefix_length": 30
}