LogoSimply SendDOCS
    API ReferenceTransactional EmailSend Transactional Email

    Send Transactional Email

    Send reliable transactional emails like password resets, order confirmations, and system notifications with high delivery rates and real-time tracking.

    POSThttps://tapi.simplysend.email/send

    Parameters

    toRequired
    string
    Email address of the recipient.
    fromRequired
    string
    The sender email address (must be a verified domain). e.g. `"Acme Newsletters" <[email protected]>` or `[email protected]`
    subjectRequired
    string
    The subject line for the email.
    htmlRequired
    string
    HTML body content. Include required template variables. See below compliance template below.
    text
    string
    The plain text version of the email for clients that don't support HTML.
    replyTo
    string
    The email address where recipients' replies should be sent. e.g. `[email protected]` or `"Acme Support" <[email protected]>`
    attachments
    array

    An array of objects containing name, contentType, and base64 encoded content.

    Up to 10 attachments per email. Combined size cannot exceed 2MB.

    PDFPNGJPGCSVDOCX
    headers
    object

    Custom headers to include in the email. e.g. { "X-Entity-ID": "user_12345", "X-Feedback-ID": "transaction_abc" }

    Note: List-Unsubscribe is automatically injected by the system.

    templateVariables
    object

    Key-value pairs for dynamic content injection. e.g. { "first_name": "John", "discount_code": "WELCOME20" }

    These can be referenced in your HTML or text body using double curly braces, e.g. {{first_name}}.

    enableClickTracking
    boolean

    Wrap all links in the email with click-tracking redirect URLs so each click is recorded as a Click event. Defaults to false.

    Only applies when your account is routed via the OCI provider. Has no effect on AWS SES sends.

    RequestPOST
    curl -X POST https://tapi.simplysend.email/send \
  -H "X-Api-Key: your_transactional_api_key" \
  -H "X-Id: your_account_id" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "[email protected]",
    "from": "sender@yourdomain.com",
    "subject": "Hello from Simply Send",
    "html": "<html><body><h1>Hello!</h1><p>Test email.</p><br><br><p>{{company_address_html}}</p><p>{{unsubscribe_email_html}}</p><p>{{report_abuse_email_html}}</p></body></html>",
    "text": "Hello! Test email."
  }'
    {
  "success": true,
  "data": {
    "message": "Email sent successfully",
    "messageId": "0100019a3908b26b-fdaeb60d-bf18-4154-91fd-1552ca877eeb-000000",
    "from": "sender@yourdomain.com",
    "totalRecipients": 1,
    "recipients": [
      {
        "email": "[email protected]",
        "status": "sent",
        "role": "to"
      }
    ],
    "status": "sent"
  }
}

    Compliance Templates