eSMS AfricaeSMS Africa
SMS Platform

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:

  1. Log in to sms.esmsafrica.io
  2. Go to Sender IDs and start a new request
  3. Enter the name (3 to 11 characters: letters, numbers and a hyphen, for example eSMS, eSMSAfrica or eSMS-UG; no spaces or underscores), the countries and your use case - the fee for each country is shown before you submit
  4. Pay the fee from Pay for Sender ID (paying the fee). It must be paid in full before approval
  5. 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:

CountryCode
GhanaGH
UgandaUG
KenyaKE
TanzaniaTZ
Cote d'IvoireCI
RwandaRW
DR CongoCD
NigeriaNG

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_id in one of the 8 countries, the country's default is used.
  • Elsewhere, a live send with no sender_id or with a default sender returns 403 with code sender_id_required and a register_url. Nothing is charged. See the API error.
  • On verification, an account gets eSMS and eSMSAfrica only 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

CountryAlphanumericRegistration required
Kenya (KE)YesYes
Uganda (UG)YesYes
Tanzania (TZ)YesYes
Nigeria (NG)YesYes
South Africa (ZA)YesYes
Ghana (GH)YesYes

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.

NetworkCalculationAmount
Safaricom and Airtel (bundled rate)One-timeUSD 108.59
TelkomOne-timeUSD 34.66
EquitelOne-timeUSD 69.32
TotalUSD 212.57

Uganda - one payment covers all networks

NetworkCalculationAmount
MTN3 months x USD 67USD 201
AirtelOne-timeUSD 67
TotalUSD 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.

On this page