Developer docs
Send SMS, place voice calls and verify phone numbers in Ghana from your own code, with the same account, balance and sender IDs you use in the dashboard.
What you can do
- Send SMS to up to 1000 numbers in one request, now or at a scheduled time, from a sender ID registered to your account.
- Track delivery per recipient, by polling a message or by receiving signed webhooks.
- Verify a phone number with a managed voice one-time code: we generate the code, call the number, read it out and check it for you.
- Place a voice call that reads out digits you choose, when you prefer to generate and check codes yourself.
Base URL
Every endpoint lives under /v1 on one host. Requests and responses are JSON.
https://api.kpododo.com/v1Authentication
Create an API key in the dashboard under Account > Developer > API keys > Create key. Give it a name and choose Live or Test. The full key is shown once, so store it somewhere safe straight away. Keys look like kp_live_ or kp_test_ followed by 40 hexadecimal characters.
Send the key as a bearer token on every request:
curl https://api.kpododo.com/v1/me \
-H "Authorization: Bearer kp_live_..."GET /v1/me tells you which account a key belongs to and whether it is a live or test key, which makes it a good first call to check your setup.
{
"user_id": "uuid",
"email": "dev@example.com",
"role": "regular",
"environment": "live"
}A key stops working if you revoke it, or if your account is disabled or not verified. Keys created in the dashboard have full access. Keep keys on your server and never ship them in a mobile app or web page.
Errors at a glance
Every error has the same shape:
{ "error": "Human readable message, may change", "code": "STABLE_MACHINE_CODE" }Branch on code, never on error. The full list is on the errors page.
All guides
Getting started
Building reliably
Reference