Email API

Base URL: https://api.mailafrica.online

Send Email

POST /v1/emails/send

Name	Type	Required	Description
`to`	string[]	Yes	List of recipient email addresses
`subject`	string	Yes	Email subject line
`text_body`	string	No	Plain text email body
`html_body`	string	No	HTML email body
`from_address`	string	No	Sender email address


{
  "to": ["user@example.com"],
  "subject": "Welcome to SendAfrica",
  "text_body": "Thank you for signing up!",
  "from_address": "welcome@sendafrica.online"
}

List Inbound Emails

GET /v1/emails/inbound

Name	Type	Default	Description
`address_id`	integer	1	Inbound address ID
`limit`	integer	20	Number of emails to retrieve

Check Email Balance

GET /v1/credits/balance


{
  "status": "success",
  "data": { "credits": 500, "wallet_balance_tzs": 15000 }
}

Error Codes

Code	Description
400	Invalid email format or missing required fields
401	Invalid API key
403	Insufficient email credits
429	Rate limit exceeded