API Reference

Send an Email

Trigger a transactional email using POST /v1/emails/send.

Target API Endpoint

POST/v1/emails/send

The primary public API endpoint triggers an email for asynchronous delivery.

Request Payload Parameters

Field	Type	Required	Description
`templateId`	string	Yes	Template ID or slug (e.g. `order-confirmation`)
`to`	string	Yes	Recipient email address
`cc`	array[string]	No	Optional CC recipient email addresses
`bcc`	array[string]	No	Optional BCC recipient email addresses
`subject`	string	No	Optional subject line override
`data`	object	No	Dynamic template variables

Response (202 Accepted)

json

{
  "id": "email_98ab71c2",
  "status": "QUEUED"
}

Multi-Language API Snippets

curl -X POST https://api.histeria.dev/v1/emails/send \
  -H "x-api-key: ck_live_secret_key_123" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "order-confirmation",
    "to": "customer@example.com",
    "data": {
      "customerName": "John Doe",
      "orderNumber": "ORD-9812",
      "total": "$149.00"
    }
  }'

Managing API Keys

Email Templates