Inbound email

Sender IDs

Create, list, and delete inbound addresses (sender IDs) programmatically. Each address receives real email on the platform domain or your own verified receiving domain.

A sender ID is a discrete inbound address you own. Every message it receives is stored on your account and debits your wallet. Create them per customer, per product, per notification type — as many as you need, up to 100.

Addresses are lowercase [a-z0-9-] only. They live either on the shared platform domain (anything@mailafrica.online) or on your own verified receiving domain.

Create an address

bash

curl -X POST https://api.mailafrica.online/api/inbound/addresses \
  -H "X-API-Key: MAIL_<your_api_key_here>" \
  -H "Content-Type: application/json" \
  -d '{"local_part": "support", "label": "Support desk"}'

Body fields: local_part (required), label (optional display label), domain_id (optional — the id of a verified receiving domain; omit to use the platform domain).

json

{
  "success": true,
  "data": {
    "id": 42,
    "user_id": 7,
    "local_part": "support",
    "label": "Support desk",
    "domain_id": null,
    "retention_days": 30,
    "created_at": "2026-08-15T00:00:00Z"
  }
}

Mail to support@mailafrica.online now routes to your account. retention_days (default 30) comes from your compliance profile.

You must have a verified email or phone before creating addresses. Unverified accounts get 403 FORBIDDEN.

List your addresses

bash

curl https://api.mailafrica.online/api/inbound/addresses \
  -H "X-API-Key: MAIL_<your_api_key_here>"

Delete an address

bash

curl -X DELETE https://api.mailafrica.online/api/inbound/addresses/42 \
  -H "X-API-Key: MAIL_<your_api_key_here>"

Errors

Status	Code	Meaning	How to fix
Client error403	`FORBIDDEN`	You don't own that domain, the domain isn't verified, or your identity isn't verified.	Verify your email/phone, and verify the receiving domain first.
Client error404	`NOT_FOUND`	The domain or address doesn't exist.	Check the `id` you passed.
Client error409	`LIMIT_REACHED`	You already have 100 addresses.	Delete unused addresses or raise the limit with support.
Client error400	`VALIDATION_ERROR`	`local_part` isn't `[a-z0-9-]` or another field is invalid.	Use lowercase letters, digits, and hyphens only.