Create address

POST /2010-04-01/Accounts/{AccountSid}/Addresses.json

An Address instance resource represents your or your customer's physical location within a country. Around the world, some local authorities require the name and address of the user to be on file with Twilio to purchase and own a phone number.

Path parameters

AccountSid string Required

The SID of the Account that will be responsible for the new Address resource.

Body

AutoCorrectAddress boolean

Whether we should automatically correct the address. Can be: true or false and the default is true. If empty or true, we will correct the address you provide if necessary. If false, we won't alter the address you provide.
City string Required

The city of the new address.
CustomerName string Required

The name to associate with the new address.
EmergencyEnabled boolean

Whether to enable emergency calling on the new address. Can be: true or false.
FriendlyName string

A descriptive string that you create to describe the new address. It can be up to 64 characters long.
IsoCountry string(iso-country-code) Required

The ISO country code of the new address.
PostalCode string Required

The postal code of the new address.
Region string Required

The state or region of the new address.
Street string Required

The number and street address of the new address.

Responses

201

Created
Hide response attributes Show response attributes object
- account_sid string | null
  
  The SID of the Account that is responsible for the resource
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.
- city string | null
  
  The city in which the address is located
- customer_name string | null
  
  The name associated with the address
- date_created string(date-time-rfc-2822) | null
  
  The RFC 2822 date and time in GMT that the resource was created
- date_updated string(date-time-rfc-2822) | null
  
  The RFC 2822 date and time in GMT that the resource was last updated
- emergency_enabled boolean | null
  
  Whether emergency calling has been enabled on this number
- friendly_name string | null
  
  The string that you assigned to describe the resource
- iso_country string(iso-country-code) | null
  
  The ISO country code of the address
- postal_code string | null
  
  The postal code of the address
- region string | null
  
  The state or region of the address
- sid string | null
  
  The unique string that identifies the resource
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AD[0-9a-fA-F]{32}$.
- street string | null
  
  The number and street address of the address
- uri string(uri) | null
  
  The URI of the resource, relative to https://api.twilio.com
- validated boolean | null
  
  Whether the address has been validated to comply with local regulation
- verified boolean | null
  
  Whether the address has been verified to comply with regulation

POST /2010-04-01/Accounts/{AccountSid}/Addresses.json

curl \
 -X POST https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Addresses.json \
 --user "username:password" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -d 'AutoCorrectAddress=true&City=string&CustomerName=string&EmergencyEnabled=true&FriendlyName=string&IsoCountry=string&PostalCode=string&Region=string&Street=string'

Request example

{
  "AutoCorrectAddress": true,
  "City": "string",
  "CustomerName": "string",
  "EmergencyEnabled": true,
  "FriendlyName": "string",
  "IsoCountry": "string",
  "PostalCode": "string",
  "Region": "string",
  "Street": "string"
}

Request examples

{
  "AutoCorrectAddress": true,
  "City": "string",
  "CustomerName": "string",
  "EmergencyEnabled": true,
  "FriendlyName": "string",
  "IsoCountry": "string",
  "PostalCode": "string",
  "Region": "string",
  "Street": "string"
}

Response examples (201)

{
  "account_sid": "string",
  "city": "string",
  "customer_name": "string",
  "date_created": "string",
  "date_updated": "string",
  "emergency_enabled": true,
  "friendly_name": "string",
  "iso_country": "string",
  "postal_code": "string",
  "region": "string",
  "sid": "string",
  "street": "string",
  "uri": "https://example.com",
  "validated": true,
  "verified": true
}

Response examples (201)

{
  "account_sid": "string",
  "city": "string",
  "customer_name": "string",
  "date_created": "string",
  "date_updated": "string",
  "emergency_enabled": true,
  "friendly_name": "string",
  "iso_country": "string",
  "postal_code": "string",
  "region": "string",
  "sid": "string",
  "street": "string",
  "uri": "https://example.com",
  "validated": true,
  "verified": true
}