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 sendStored 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.

Response
{
  "error": "One or more recipients are not valid phone numbers",
  "code": "INVALID_RECIPIENTS",
  "invalid_recipients": ["0244", "hello"]
}