Objective
Regulatory requirements in some countries mandate that Twilio collect information about the phone number’s end-user before we can allocate a number. When we are required to collect the end-user’s address, we may, depending on the country that the address is in, validate the address with an external provider. If you’re creating a new address in one of those countries via Console, you may get an address suggestion when we find a close match, while via API you may get an address suggestion in the error response.
Product
Phone Numbers
Process
Address validation services are not perfect and sometimes valid addresses aren’t found or are in the incorrect format. If that happens, please try alternative formats of your address.
Notice: If you are having trouble adding an address that requires a proof of documentation for regulatory requirements, ensure you are adding the address within the bundle creation process using this process: How to Submit a Regulatory Bundle for Phone Number Regulatory Compliance
Some best practices are to:
All fields
- Be sure NOT to add any extra spaces before or after any of the information enter in each field.
Customer Name, Friendly Name
- Remove special characters and symbols like "&", "@", "#".
- Emergency Address: 32 character limit
- Regulatory Compliance: 64 character limit
Street
- Use abbreviations where possible, i.e., "St" for Street, "Ave" for Avenue, "Bl" for Boulevard, etc.
- Do NOT use punctuation with the abbreviation.
- Remove special characters and symbols like "&", "@", "#".
Locality
- Remove special characters and symbols like "&", "@", "#".
Region
- Use the two-letter abbreviation for the State field, i.e., "CA" for California.
- Use capital letters and no punctuation.
Notice: For United States addresses enter the "State" using the state abbreviation. The "State" field will only accept states formatted in two-letter abbreviations, e.g., TX, NY, CA. If written out ('Texas', 'New York', 'California') the address will be rejected.
Postal Code
- Use the standard 5-digit ZIP Code, not the 5+4 format.
If you’re still having problems validating your address, please contact our Support team.
Note: Addresses currently linked to phone numbers for Regulatory Compliance usage or Emergency Address registration cannot be modified or re-validated. You may need to create a new address for Emergency Address registration if you are not able to modify a current Regulatory Compliance address due to number associations.