Receipts, alerts and one-time codes by email to customers in South Africa, from a domain you verify once. Billed in ZAR on the same account and key as your SMS.
POPIA governs personal information. Opt-out must be honoured within a reasonable period and free of charge.
Opt-out keywords honoured automatically: STOP, UNSUBSCRIBE, CANCEL, END, QUIT.
southafrica.woyra.ioGlobal
curl -X POST https://southafrica.woyra.io/v1/emails \
-H "Authorization: Bearer $WOYRA_KEY" \
-H 'Idempotency-Key: receipt-4821' \
-H 'Content-Type: application/json' \
-d '{
"from": "receipts@yourdomain.com",
"to": "abebe@example.com",
"subject": "Your receipt for order 4821",
"text": "Thank you. Your order is confirmed."
}'The same key works on every endpoint. Calling southafrica.woyra.io applies South Africa's rules and, where residency requires it, keeps the data in the global region.
Alphanumeric sender IDs, no registration · billed in ZAR · global data region
Mail to South Africa is carried the way mail is carried everywhere: a domain you verify once, DKIM keys Woyra generates, bounces and complaints suppressed automatically. What the South Africa endpoint changes is the account around it — ZAR billing, and the global data region.
Global The residency of a message is decided when it is accepted and travels with it, so it cannot be moved later by a query written somewhere else.
An account on the South Africa endpoint is billed in US dollars today. Billing in ZAR is where this is going, and it is a real advantage when it arrives, but a converted price needs a published rate behind it and there is not one yet, so we quote one currency rather than invent a second. Funds are reserved at the published price when a message is accepted and settled when it is delivered; a message we never deliver is never charged for, and a hard spend cap you set is enforced rather than invoiced.
The same key sends SMS and one-time codes to +27 numbers, and the same domain receives: add the MX record and every address on it is an inbox, with replies linked to the email they answer.
No. Email is carried the same way everywhere; what changes is the account: ZAR billing and the global data region.
Global
Yes. One key covers email, SMS, verification and lookup, and a verification can use both channels in one request.
E.164: a plus, the country code +27, then the subscriber number, as in +27712345678. Woyra strips spaces, hyphens, brackets and a leading 00, but it will not guess a missing country code, because the same digits belong to a different subscriber in every country.
southafrica.woyra.io, though the same API key works on every endpoint Woyra runs. Which one you call decides the compliance rules applied, the currency you are billed in, and — where residency requires it — which data plane answers.