Sawala CloudSawala Cloud — Docs
SebarReference

Sebar API Reference

Sebar's public send endpoint — base URL, the full request body, and the delivery states a message moves through.

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

The public API exposes a single operation: sending a message. Authoring templates and browsing sent messages happen in the dashboard.

Base URL

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

Authentication

Send an API key scoped for Sebar in the X-API-Key header. Sends are a server-side operation — use a secret key and keep it off the browser.

Send a message

POST /notifications/send

Request body

FieldTypeNotes
to{ email, name? }Required. The recipient.
templateIdstringTemplate slug to render. Required unless you supply an inline subject + body.
subjectstringInline subject (template-free sends).
bodyHtmlstringInline HTML body.
bodyTextstringInline plain-text body.
from{ email, name? }Optional sender override.
replyTo{ email, name? }Optional reply-to.
variablesobjectValues for {{placeholders}} — string, number, or boolean.
tagsstring[]Labels for filtering your activity.
metadataobjectString key/values attached to the message.
projectIdstringOptional explicit project (otherwise inferred from the key).

Each request must carry either a templateId or an inline subject with bodyHtml and/or bodyText.

A successful send returns the created message's id.

Delivery states

A message's status is advanced by the provider, never by the caller, and never moves backward once terminal:

StatusMeaning
queuedAccepted and waiting to send
sentHanded to the email provider
deliveredAccepted by the recipient's server
bouncedHard bounce — undeliverable
spamMarked as a spam complaint
suppressedBlocked by the organization's suppression list
failedNon-retryable error

Hard bounces and spam complaints add the address to your organization's suppression list automatically, so later sends to it are suppressed rather than re-attempted. Suppressions are managed in the dashboard.

For task-oriented examples, see How to send email.

Daftar Isi