How to send email

TODO: translate to Indonesian. English source is authoritative; render it into Indonesian below.

Every send is one POST to:

https://api.sawala.cloud/public/sebar/notifications/send

with an API key in X-API-Key. Send from your server. The recipes below cover the common variations.

Personalize with a template

Reference a template by slug and pass variables for its {{placeholders}}:

{
  "templateId": "welcome",
  "to": { "email": "ada@example.com", "name": "Ada" },
  "variables": { "name": "Ada", "plan": "Pro" }
}

Variable values can be strings, numbers, or booleans.

Send without a template

For one-off messages, skip the template and pass an inline subject plus an HTML and/or text body:

{
  "to": { "email": "ada@example.com" },
  "subject": "Your export is ready",
  "bodyHtml": "<p>Your export finished. <a href=\"…\">Download</a></p>",
  "bodyText": "Your export finished: …"
}

Set the sender and reply-to

from and replyTo are optional and take the same { email, name } shape as to:

{
  "templateId": "welcome",
  "to": { "email": "ada@example.com" },
  "from": { "email": "hello@acme.com", "name": "Acme" },
  "replyTo": { "email": "support@acme.com" }
}

Tag messages for filtering

Use tags and metadata to label sends so you can slice your activity later:

{
  "templateId": "welcome",
  "to": { "email": "ada@example.com" },
  "tags": ["onboarding"],
  "metadata": { "campaign": "spring", "userId": "u_123" }
}

metadata values are strings.

Track delivery

A message advances queued → sent → delivered, or lands in bounced, spam, suppressed, or failed. You watch this — and read each message's delivery log — in the Sebar dashboard. Hard bounces and spam complaints automatically add the address to your organization's suppression list, so Sebar won't keep mailing an address that rejected you.

See the API reference for the complete request body and status list.