eSMS Mail
Domains
Adding and verifying domains for email sending.
Before sending emails from your own domain, you need to add and verify it in eSMS Mail.
Add a domain
- Go to Domains in the eSMS Mail dashboard
- Click Add Domain
- Enter your domain name (e.g.
example.com)
eSMS Mail generates five DNS records you need to add:
| Record | Type | Host | Purpose |
|---|---|---|---|
| Domain Ownership | TXT | yourdomain.com | Proves you own the domain |
| SPF — Sender Authorization | TXT | yourdomain.com | Authorizes eSMS Mail to send on your behalf |
| DKIM — Email Signature | TXT | esms._domainkey.yourdomain.com | Cryptographic signature for email authentication |
| DMARC — Abuse Policy | TXT | _dmarc.yourdomain.com | Tells receivers what to do when authentication fails |
| Return Path — Bounce Handling | CNAME | esms-bounce.yourdomain.com → bounces.send.esmsafrica.io | Routes bounce notifications back to eSMS Mail |
API
Create a domain
curl -X POST https://send.esmsafrica.io/v1/domains/ \
-H "Authorization: Bearer esms_k_your_api_key" \
-H "Content-Type: application/json" \
-d '{"name": "example.com"}'List domains
curl https://send.esmsafrica.io/v1/domains/ \
-H "Authorization: Bearer esms_k_your_api_key"Get domain with DNS records
curl https://send.esmsafrica.io/v1/domains/{domain_id} \
-H "Authorization: Bearer esms_k_your_api_key"The response includes all required DNS records and their verification status.
Trigger verification
curl -X POST https://send.esmsafrica.io/v1/domains/{domain_id}/verify \
-H "Authorization: Bearer esms_k_your_api_key"eSMS Mail also checks DNS records automatically every few seconds. Once all records are verified, the domain status changes to verified and you'll receive a confirmation email.
DNS diagnostics
curl https://send.esmsafrica.io/v1/domains/{domain_id}/diagnose \
-H "Authorization: Bearer esms_k_your_api_key"Returns actionable diagnostics if your DNS is misconfigured — for example, missing SPF includes, multiple SPF records, or conflicting DKIM keys.
Domain limits
The number of domains you can add depends on your plan:
| Plan | Max domains |
|---|---|
| Free | 1 |
| Starter | 3 |
| Pro | 10 |
| Business | Unlimited |