Guides

Send an email

POST /api/v1/transactional/send sends a single email. It is DKIM-signed, uses a VERP return-path for accurate bounce handling, and tracks opens and clicks when an HTML body is present.

Request body

Field	Required	Description
to	yes	Recipient email address
from_email	yes	Sender on a verified domain
subject	yes	Email subject
html	—	HTML body (enables tracking)
text	—	Plain-text body
from_name	—	Friendly sender name

Response

{ "success": true, "data": {
  "message_id": "<...@send.relayly.io>",
  "status": "sent", "ip": "...", "mail_from": "bounce+...@..." } }

Sends are gated by your email credits and the platform send switch. A blocked status with reason insufficient_email_credits means you need to top up.