Send email from your code

Your console#

Everything you set up lives in one place: Settings → API. Make a key there, connect the domain you send from and publish its records, register a webhook, create sub-accounts, connect your own database, and see the suppression list and your credits. Every page of this reference assumes you have been there once.

Each endpoint in the reference has a Try it button. Paste your key once and you can send real requests from the page, edit the sample, and read the answer. Sending an email starts in sandbox mode, which checks everything and delivers nothing.

Your first send#

curl https://barua.tz/api/v1/emails \
  -H "Authorization: Bearer barua_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "sales@yourdomain.co.tz",
    "to": "customer@gmail.com",
    "template": { "name": "receipt", "total": "25,000", "paymentMethod": "M-Pesa" }
  }'

The same thing from Node, or anything else with fetch:

await fetch("https://barua.tz/api/v1/emails", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BARUA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    from: "sales@yourdomain.co.tz",
    to: "customer@gmail.com",
    template: { name: "receipt", total: "25,000", paymentMethod: "M-Pesa" },
  }),
});

Rules#

• from must be on a domain your account has verified in your console. A bare address or "Name <address>" both work.
• to is one address or an array of up to 10.
• 60 emails per minute per key, and a daily limit shown on your API settings page.
• Keys belong on servers. Never ship one in an app or a web page. Anyone who can view source can then send as you.
• Send only to people who gave you their address. Bounces and spam reports are counted per account, and enough of either pauses sending automatically. That is what keeps everyone else's mail out of the spam folder.

Responses#

Success is 200 with { "id": "..." }. Everything else says what to fix: