Sender Addresses

Before you can send any email through eSMS Mail, you must create a sender address. This is the "from" address your recipients will see (e.g. hello@yourdomain.com, billing@yourdomain.com).

Create a sender address

Via dashboard

1. Go to Sender Addresses in the sidebar
2. Click Create
3. Select a verified domain from the dropdown
4. Enter the email address (e.g. hello@yourdomain.com)
5. Enter a display name (e.g. "Your Company" — this is what recipients see next to the email)

Via API

curl -X POST https://send.esmsafrica.io/v1/sender-addresses/ \
  -H "Authorization: Bearer esms_k_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "domain_id": "your_domain_id",
    "email": "hello@yourdomain.com",
    "display_name": "Your Company"
  }'

{
  "id": "sa_123",
  "email": "hello@yourdomain.com",
  "display_name": "Your Company",
  "domain_id": "your_domain_id",
  "is_active": true,
  "created_at": "2025-01-15T10:00:00Z"
}

Requirements

• Domain must be verified — all 5 DNS records must be passing. You'll get a 400 error if the domain is still pending.
• Email must match the domain — hello@yourdomain.com requires the yourdomain.com domain to be added and verified. You can't create hello@other.com on the yourdomain.com domain.
• Unique email addresses — each sender email must be unique. You can't create the same email twice.

Using sender addresses

When sending an email, the from field must use a sender address you've created:

{
  "from": {
    "email": "hello@yourdomain.com",
    "name": "Your Company"
  },
  "to": [{"email": "user@example.com"}],
  "subject": "Hello!",
  "html": "<p>Sent from a verified sender address.</p>"
}

If the from email doesn't match any active sender address on a verified domain, the email is rejected with a rejection_reason.

Multiple sender addresses

You can create multiple sender addresses on the same domain for different purposes:

List sender addresses

curl https://send.esmsafrica.io/v1/sender-addresses/ \
  -H "Authorization: Bearer esms_k_your_api_key"

Delete a sender address

curl -X DELETE https://send.esmsafrica.io/v1/sender-addresses/{address_id} \
  -H "Authorization: Bearer esms_k_your_api_key"

Deleting a sender address means you can no longer send emails from that address. Existing sent emails are not affected.

Limits

The number of sender addresses depends on your plan. Check your current usage on the Billing page.