Sender IDs
Register and manage custom SMS sender names.
A sender ID is the name or number displayed as the sender when an SMS is received. Different countries have different rules for sender IDs.
How sender IDs work
- Sender IDs are alphanumeric (e.g. "eSMS", "MyApp") or numeric (e.g. a short code)
- Some countries require pre-registration with the telecom regulator
- A default sender ID can be used only in 8 countries. Everywhere else you must register your own
Managing sender IDs
To request your own sender ID:
- Log in to sms.esmsafrica.io
- Go to Sender IDs and start a new request
- Enter the name (3 to 11 characters: letters, numbers and a hyphen, for example
eSMS,eSMSAfricaoreSMS-UG; no spaces or underscores), the countries and your use case - the fee for each country is shown before you submit - Pay the fee from Pay for Sender ID (paying the fee). It must be paid in full before approval
- The team registers it with the networks
Most networks need KYC documents and a signed service order form before they register a sender ID. Complete Onboarding and KYC once in the dashboard and we attach it to every sender ID registration, so approvals are faster.
You can also request one over the API with
POST /api/sender-ids.
Default sender IDs
Default sender IDs (eSMS, eSMSAfrica and each country's route default) can be used
only in these 8 countries:
| Country | Code |
|---|---|
| Ghana | GH |
| Uganda | UG |
| Kenya | KE |
| Tanzania | TZ |
| Cote d'Ivoire | CI |
| Rwanda | RW |
| DR Congo | CD |
| Nigeria | NG |
Everywhere else you must register your own sender ID, because spammers misused the default sender IDs. Only eSMS Africa can assign a default sender to a specific account. A customer outside the 8 countries who used a default sender in the last 90 days and has wallet credit keeps it.
- If you leave out
sender_idin one of the 8 countries, the country's default is used. - Elsewhere, a live send with no
sender_idor with a default sender returns403with codesender_id_requiredand aregister_url. Nothing is charged. See the API error. - On verification, an account gets
eSMSandeSMSAfricaonly if its home country is one of the 8. - Test keys (
esms_test_) still accept the default sender and flag it, so you can see what a live send would do. See Test keys.
GET /api/sender-ids/default shows
what applies to your account.
Per-country rules
| Country | Alphanumeric | Registration required |
|---|---|---|
| Kenya (KE) | Yes | Yes |
| Uganda (UG) | Yes | Yes |
| Tanzania (TZ) | Yes | Yes |
| Nigeria (NG) | Yes | Yes |
| South Africa (ZA) | Yes | Yes |
| Ghana (GH) | Yes | Yes |
Registration requirements and timelines vary by country. Contact support for details.
Sender ID pricing
Sender ID fees are stated in USD per country and are independent of top-ups. Your SMS credit is not used for them. The fee is shown upfront on the request form in the dashboard.
USD 100 one-time - covers all networks
In every African country except Kenya and Uganda, one flat fee of USD 100 per country registers your sender ID on every network.
A request that covers several countries is charged USD 100 for each of them (Kenya and Uganda use the bundles below).
Kenya - one payment covers all networks
One-time, with no monthly maintenance.
| Network | Calculation | Amount |
|---|---|---|
| Safaricom and Airtel (bundled rate) | One-time | USD 108.59 |
| Telkom | One-time | USD 34.66 |
| Equitel | One-time | USD 69.32 |
| Total | USD 212.57 |
Uganda - one payment covers all networks
| Network | Calculation | Amount |
|---|---|---|
| MTN | 3 months x USD 67 | USD 201 |
| Airtel | One-time | USD 67 |
| Total | USD 268 |
After the first 3 months, MTN is UGX 250,000 per month, charged in USD at the exchange rate at that time. Your SMS credit is not used for it. Nothing is debited automatically: we contact you when it is due.
Paying the fee
Pay the fee through Pay for Sender ID, by mobile money or card in Uganda, Kenya and Rwanda, card elsewhere, M-Pesa Send Money in Kenya, or crypto. Your SMS credit is not used for Sender ID fees. Registration needs the fee paid in full before approval.
- A fee is one payment, in full. The amount is fixed to what is due and anything else is refused, on every payment method.
- The total shows the processing fee. A mobile money or card checkout may add its own charge, which it shows before you confirm and which you pay on top.
- If a country is not available yet, we cannot send there today: you can still submit the request, you are not charged, and it cannot be paid until the country is available.
- The payment is held on the request and goes to your balance if it is rejected or deleted.
Current fees for all 54 countries are on esmsafrica.io/pricing
and from the public GET /api/sender-ids/fees
endpoint.