Phone number formats

Use a US or Canada mobile number as phone_number when you create a message.

Recommended format

Send 11 digits with country code 1, no spaces or symbols:

15551234567

You can also send a 10-digit US or Canada number. We add the country code for you:

5551234567

Other accepted formats

These are equivalent to the examples above:

• +15551234567
• +1 (555) 123-4567
• (555) 123-4567
• 555-123-4567
• 555.123.4567

Spaces, dashes, parentheses, dots, and a leading + are fine. We ignore them.

What is not accepted

• Numbers with fewer than 10 digits
• Numbers with more than 11 digits
• 11-digit numbers that do not start with 1
• Numbers outside the US and Canada (for example a UK number)

Tips

• Prefer a string in your JSON, for example "phone_number": "15551234567".
• Do not send an empty value. phone_number is required.