Developer changelog
What's new for developers
Changes to the eSMS Africa APIs, SDKs, sandbox, webhooks and docs, with breaking changes called out first. Last updated 28 October 2026.
October 2026 Breaking changes
- Destination countries and sender IDs are now checked on every send path, including single, bulk, batch, campaigns, Verify and scheduled sends. A country not enabled on your account returns 403 country_not_enabled, and an unapproved sender returns 403 sender_not_approved.
- API keys can no longer manage team workspaces, and sandbox (test) keys cannot read or change live campaigns.
- Text fields longer than their limit now return 422 with a field error instead of a server error.
- Retrying a message that is still being confirmed returns 409 delivery_being_confirmed. Wait until it shows sent or failed.
October 2026 SMS API
- New POST /v1/messages/batch for personalised sends, with merge fields and fallbacks, Idempotency-Key support, pricing per recipient and optional link tracking.
- Campaigns, Imports, Jobs, Contacts, Groups, Templates and Workspaces APIs under /v1.
- New Confirming status: a message waiting on network confirmation reports status unknown in the API and shows as Confirming in the dashboard, exports and campaign recipient lists. It settles to sent, or to failed with an automatic refund.
- Cancel a scheduled message or a whole scheduled batch through the API, and the unused credit returns to your wallet.
- Message cost is always reported in your wallet currency, with cost_currency alongside it.
- skip_unavailable lets a mixed bulk list continue past numbers you cannot send to, and 402 insufficient-balance errors now include the currency.
October 2026 Webhooks
- Delivery-report payloads now include cost_currency, batch_id, error_message and campaign_id.
- New campaign.completed webhook, set per campaign or once for your account.
- Every webhook is signed, and the SDKs include a helper to verify the signature.
- PUT /webhooks now creates your webhook settings on first use instead of returning 404.
October 2026 Sandbox
- Sandbox bulk and batch sends fire the same webhooks as live traffic, marked livemode:false.
- Idempotency-Key is honoured in the sandbox, so you can test retry handling before going live.
- Two-Way SMS sandbox with simulated phones for testing inbound messages and replies.
October 2026 SDKs
- SDK 1.2.0 for Node.js (npm esms-sms), Python (PyPI esms-sms) and Go (module v1.2.0).
- New resources for batch sends, campaigns, imports, contacts, groups and templates, plus Verify and opt-outs.
- Bulk sends set an Idempotency-Key automatically, so retries never double-send or double-charge.
- Cancel helpers for scheduled messages and batches, and a timeout that now covers the full response.
- A PHP SDK will follow; until then, PHP projects can call the REST API directly.
October 2026 Two-Way & keys
- Two-Way SMS API: shared short codes with keyword routing, conversation replies and inbound webhooks.
- Choose permissions when you create an API key, including read-only and Two-Way scopes, for least-privilege integrations.
- Campaign links are tracked automatically, with clicks per recipient in the report API and exports.
October 2026 Docs & dashboard
- Developer documentation now lives in one place at docs.esmsafrica.io, and old documentation links forward there automatically.
- Corrected code samples across the guides, with the current base URL and /v1 paths.
- Refreshed developer screens in the eSMS App: API keys, webhook logs, request logs and the playground.
- Security and reliability improvements across every API.
August 2026 SMS API
- Idempotency-Key support on sends, so retries never double-send or double-charge.
- New /v1 paths, rate-limit headers, a batch message-status endpoint and a consistent error format.
- Price-check (/rate) and number-validation (/validate) endpoints let you confirm cost and format before sending.
- STOP and opt-out requests are honoured on single, bulk and scheduled sends.
- Interactive Swagger explorer and 10 new SMS API reference pages in the docs.
August 2026 Sandbox & tools
- Developer sandbox with test keys (esms_test_) and a simulated lifecycle from queued to delivered, with webhooks marked livemode:false.
- iPhone simulator in the dashboard: watch test messages land on a virtual phone.
- API playground, plus webhook logs with retry and replay and a log of your API requests.
- The composer shows GSM-7 or Unicode character and segment counts live.
August 2026 Verify
- Launched eSMS Verify: a managed OTP API that sends, checks and expires codes for you.
- Verify Apps let you set brand, message template, code length, expiry and allowed countries for each app.
- Fetch, resend, cancel and list endpoints, Idempotency-Key on start, and a test mode with a fixed code.
- Failed OTP sends are never charged, and the API returns a clear error instead of a pending status.
August 2026 SMPP
- Delivery-report push webhooks for each bind, plus inbound (MO) webhooks for two-way traffic.
- Self-service message trace: follow the lifecycle of any message from the SMPP portal.
- Per-bind delivery reports with CSV export.
August 2026 Mail & Links APIs
- eSMS Mail send API: Idempotency-Key support, a sandbox that runs the full queued, sent and delivered lifecycle, and a webhook delivery log with resend.
- eSMS Mail analytics by tag, domain or stream, with CSV export.
- eSMS Links REST API with scoped API keys, test keys and a webhook on every click.
- Security and reliability improvements across every API.
July 2026 SDKs
- First official SDKs, version 1.0.0, for Node.js (npm esms-sms), Python (PyPI esms-sms) and Go.
June 2026 Docs
- Refreshed API and SMPP documentation with quick-start guides.
- Global phone-number support across sign-up and the dashboard.
May 2026 SMS API
- Real-time delivery receipts and message logs across the API and SMPP.
- Help Center with searchable guides and FAQs.
Full reference at docs.esmsafrica.io. Have a question or a feature request? Talk to us.