🇪🇺 EU (Frankfurt) and 🇨🇦 Canada region support is coming soon — stay tuned!

    LogoSimply SendDOCS
    API ReferenceMarketing EmailSend Marketing Email

    Send Marketing Email

    The Marketing Email API (MAPI) is designed for promotional content, newsletters, and large-scale campaigns. It includes built-in compliance checks and asynchronous queue-based processing.

    POSThttps://mapi.simplysend.email/send

    Parameters

    toRequired
    string
    Email address of the recipient.
    fromRequired
    string
    The sender email address (must be a verified domain).
    subjectRequired
    string
    The email subject line.
    contactListIdRequired
    string
    Required for marketing emails to track consent and apply compliance templates. Approval required to make this optional.
    htmlRequired
    string
    HTML body content. MUST include required template variables. See below compliance template below.
    headers
    object
    Custom headers to include. Note: List-Unsubscribe is automatically injected by the system.
    text
    string
    Plain text version of the email.
    replyTo
    string
    Email address for replies.
    templateVariables
    object
    Key-value pairs for dynamic content injection.
    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.

    campaignId
    string

    Associate the emails with a campaign. Create the campaign first using the SimplySend UI. Email analytics events (send, delivery, open, click, bounce, etc.) are recorded against the campaign Id.

    RequestPOST
    curl -X POST https://mapi.simplysend.email/send \
  -H "X-Api-Key: your_marketing_api_key" \
  -H "X-Id: your_account_id" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "subscriber@example.com",
    "from": "marketing@yourdomain.com",
    "subject": "Special Offer - 20% Off",
    "html": "<html><body><h1>20% Off!</h1><p>Visit our store.</p><br><br><p>{{company_address_html}}</p><p>{{unsubscribe_email_html}}</p><p>{{report_abuse_email_html}}</p></body></html>",
    "contactListId": "list_abc123",
    "campaignId": "campaign_id123"
  }'
    {
  "success": true,
  "data": {
    "message": "Marketing email queued for processing",
    "jobId": "job_1234567890_abc",
    "status": "queued",
    "from": "marketing@yourdomain.com",
    "totalRecipients": 1,
    "recipients": [
      {
        "email": "subscriber@example.com",
        "status": "queued",
        "role": "to"
      }
    ]
  }
}

    Consent & Compliance

    Permission-Based Marketing

    All recipients MUST have valid consent records. If a recipient lacks valid consent or has unsubscribed, the API will reject the send request.

    Auto-Injected Headers

    List-Unsubscribe & List-Unsubscribe-Post

    The system automatically injects required RFC 8058 compliant headers (with one-click unsubscribe support) unless explicitly overridden in the request payload.

    Compliance Templates