Create ip record

POST /v1/IpRecords

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

Body

  • 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.

  • FriendlyName string

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

  • IpAddress string Required

    An IP address in dotted decimal notation, IPv4 only.

Responses

  • 201

    Created

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

      The SID of the Account that created the resource

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

    • cidr_prefix_length integer | null

      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.

    • date_created string(date-time) | null

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

    • date_updated string(date-time) | null

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

    • 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.

    • sid string | null

      The unique string that identifies the resource

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

    • url string(uri) | null

      The absolute URL of the resource

POST /v1/IpRecords
curl \
 -X POST https://voice.twilio.com/v1/IpRecords \
 --user "username:password" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -d 'CidrPrefixLength=42&FriendlyName=string&IpAddress=string'
Request example
{
  "CidrPrefixLength": 42,
  "FriendlyName": "string",
  "IpAddress": "string"
}
Request examples
{
  "CidrPrefixLength": 42,
  "FriendlyName": "string",
  "IpAddress": "string"
}
Response examples (201)
{
  "account_sid": "string",
  "cidr_prefix_length": 42,
  "date_created": "2023-05-04T09:42:00+00:00",
  "date_updated": "2023-05-04T09:42:00+00:00",
  "friendly_name": "string",
  "ip_address": "string",
  "sid": "string",
  "url": "https://example.com"
}
Response examples (201)
{
  "account_sid": "string",
  "cidr_prefix_length": 42,
  "date_created": "2025-05-04T09:42:00Z",
  "date_updated": "2025-05-04T09:42:00Z",
  "friendly_name": "string",
  "ip_address": "string",
  "sid": "string",
  "url": "https://example.com"
}