SUPPORT.TWILIO.COM END OF LIFE NOTICE: This site,, is scheduled to go End of Life on February 27, 2024. All Twilio Support content has been migrated to, where you can continue to find helpful Support articles, API docs, and Twilio blog content, and escalate your issues to our Support team. We encourage you to update your bookmarks and begin using the new site today for all your Twilio Support needs.

How do I add, update, or map an address?

You can add or update your addresses either directly through the Console or by using our REST API.

To add your address using the Console, you can navigate to the 'Manage Addresses' page and select the "Add New Address" option. To update your existing address using the Console, you'll want to navigate to the 'Manage Addresses' page and click on the Friendly Name of the address you would like to edit.

To add or update your address through the REST API, you'll need to make a POST request to the addresses instance resource. Our REST API documentation on addresses includes more examples on how you can do this in the programming language of your choice.

Please keep in mind that the IsoCountry of an address cannot be updated. To modify the country of an address, you must create a new address.

Map existing addresses to a phone number

If you have existing numbers on your Twilio project that need to be mapped to an address, please follow the instructions below to map your existing numbers.

  1. Login to your project at
  2. Navigate to Phone Numbers > Manage Numbers.
  3. Click the desired phone number to map.
  4. Under the Regulatory Information section, select the Address and/or Identity Document you wish to use, and then click Save.
Have more questions? Submit a request
Powered by Zendesk