If a message shows as failed or undelivered, check these common causes:

  • Invalid number: ensure the number is in international format (e.g. +254712345678).
  • Insufficient balance: top up in Billing.
  • Unregistered sender ID: some countries require a registered sender ID.
  • Operator filtering: promotional content may be filtered; use a registered ID and compliant content.
  • Handset off / out of coverage: the operator will retry for a period before expiry.

The delivery report includes the operator error code to help you diagnose. Still stuck? Contact support@esmsafrica.io.