Email API
Send transactional email
with one HTTPS request.
A REST endpoint built for modern applications and SDKs. Authenticate with a Bearer key, post a structured payload, get a message ID back immediately — then follow the message through structured delivery events.
REST over HTTPS
POST to /v1/send. Typed payloads, JSON responses, and a stable message identifier for every accepted send.
Idempotent retries
Pass an idempotency key so network timeouts do not create duplicate password resets or double confirmations.
Scoped API keys
Bearer tokens scoped per environment. Rotate keys without rewriting application code.
Same pipeline as SMTP
API and SMTP land in the same delivery path. Same logs, same webhooks, same reputation controls.
Example
Minimal send request
Request
POST https://api.notifiva.com/v1/send
Authorization: Bearer $NOTIFIVA_API_KEY
Content-Type: application/json
{
"from": "[email protected]",
"to": "[email protected]",
"subject": "Your order is completed",
"html": "<p>Hi, your order is completed.</p>"
}
Response — 202 Accepted
{
"success": true,
"code": 202,
"data": {
"messageId": "01a0d767-6b46-7ed6-9ed9-8cd33be06fe3",
"to": "[email protected]",
"submittedAt": "2026-09-25T07:11:14.246781+00:00"
}
}
Full schema, SDKs and language examples are available in the documentation. See also SMTP relay if you prefer to keep an existing mailer configuration.