Phone number formats
Send numbers the way your users typed them. The API accepts the common Ghana formats and returns every number in E.164.
Ghana numbers
All of these are the same number, and all are accepted:
| You send | Stored and returned as |
|---|---|
0244000111 | +233244000111 |
244000111 | +233244000111 |
233244000111 | +233244000111 |
+233244000111 | +233244000111 |
+233 24 400 0111 | +233244000111 |
00233244000111 | +233244000111 |
+2330244000111 (a stray 0 after the country code) | +233244000111 |
- Spaces, dashes, dots and brackets are ignored.
- After the country code, a Ghana number must be 9 digits starting with 2, 3 or 5.
Other countries
Numbers outside Ghana must start with + and the country code, and have 8 to 15 digits in total.
E.164 in responses
Every number is normalised to E.164 (for example +233244000111) and returned that way in responses and webhooks. Store that form on your side so you can match results to your records.
In POST /v1/sms, duplicates are removed after normalising, keeping the first occurrence. Sending 0244000111 and +233244000111 in the same request sends one message to that number.
Invalid numbers
If any to entry is not a phone number, the whole request is refused with 400 INVALID_RECIPIENTS. Nothing is sent or charged, and invalid_recipients lists the entries to fix.
{
"error": "One or more recipients are not valid phone numbers",
"code": "INVALID_RECIPIENTS",
"invalid_recipients": ["0244", "hello"]
}