Phone Formatting
Sendiee stores and transmits all phone numbers in full international format without the + sign. Understanding this format is important for all endpoints that accept phone numbers.
International Format
All phone numbers follow the format {countryCode}{number} — no spaces, dashes, parentheses, or + sign.
The defaultCountryCode Field
If you pass a local phone number (without the country code), you can include the defaultCountryCode parameter and Sendiee will automatically prepend it.
| Input | defaultCountryCode | Stored As |
|---|---|---|
| 9876543210 | 91 | 919876543210 |
| 919876543210 | — | 919876543210 |
| 0501234567 | 971 | 971501234567 |
| +1 (555) 123-4567 | — | 15551234567 |
| 07911 123456 | 44 | 447911123456 |
Validation
Sendiee automatically sanitises phone numbers by removing spaces, + signs, dashes, and parentheses before validation. If the resulting number is still invalid, the API returns an INVALID_PHONE_NUMBER (400) error.
Best Practice
Always send phone numbers in the fully qualified international format (e.g.,
919876543210) without relying on defaultCountryCode. This eliminates ambiguity and ensures consistent behaviour.