API documentation

Send email over a simple HTTPS API. Base URL: https://api.emarketing.com.ng

Authentication

Pass your API key in the x-api-key header. Create keys in the dashboard under API & SMTP.

x-api-key: em_live_xxxxxxxxxxxx

Send an email

POST /v1/email

curl https://api.emarketing.com.ng/v1/email \
  -H "x-api-key: em_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "customer@example.com",
    "from": "news@yourdomain.com",
    "subject": "Welcome aboard",
    "html": "<h1>Hello!</h1><p>Thanks for joining.</p>"
  }'

Response:

{ "id": "msg_...", "messageId": "010f...", "status": "SENT" }

SMTP

Prefer SMTP? Generate SMTP credentials in the dashboard and point your app at our relay:

Host: smtp.emarketing.com.ng
Port: 587 (STARTTLS)
Username: <your SMTP username>
Password: <your SMTP password>

Webhooks

Register an endpoint in the dashboard to receive signed events (DELIVERY, OPEN, CLICK, BOUNCE, COMPLAINT). Verify the x-webhook-signature header (HMAC-SHA256 of the raw body with your webhook secret).

Suppression

Hard bounces and complaints are auto-suppressed per account. Manage your suppression list in the dashboard or via the API.