Skip to main content
POST
/
mails
/
bulk
curl --request POST \
  --url https://api.autosend.com/v1/mails/bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "recipients": [
    {
      "email": "[email protected]",
      "name": "Jane Smith",
      "dynamicData": {
        "firstName": "Jane",
        "orderNumber": "ORD-123",
        "orderTotal": "$19.99"
      }
    },
    {
      "email": "[email protected]",
      "name": "John Doe",
      "dynamicData": {
        "firstName": "John",
        "orderNumber": "ORD-124",
        "orderTotal": "$29.99"
      }
    }
  ],
  "from": {
    "email": "[email protected]",
    "name": "Your Company"
  },
  "subject": "Welcome to Our Platform!",
  "html": "<h1>Welcome, {{name}}!</h1><p>Thanks for signing up.</p>",
  "replyTo": {
    "email": "[email protected]"
  }
}'

{
  "success": true,
  "data": {
    "batchId": "ae22c1e0-2022-4f6b-bdca-ce94901fbc6e",
    "totalRecipients": 2,
    "successCount": 2,
    "failedCount": 0
  }
}

curl --request POST \
  --url https://api.autosend.com/v1/mails/bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "recipients": [
    {
      "email": "[email protected]",
      "name": "Jane Smith",
      "dynamicData": {
        "firstName": "Jane",
        "orderNumber": "ORD-123",
        "orderTotal": "$19.99"
      }
    },
    {
      "email": "[email protected]",
      "name": "John Doe",
      "dynamicData": {
        "firstName": "John",
        "orderNumber": "ORD-124",
        "orderTotal": "$29.99"
      }
    }
  ],
  "from": {
    "email": "[email protected]",
    "name": "Your Company"
  },
  "subject": "Welcome to Our Platform!",
  "html": "<h1>Welcome, {{name}}!</h1><p>Thanks for signing up.</p>",
  "replyTo": {
    "email": "[email protected]"
  }
}'

{
  "success": true,
  "data": {
    "batchId": "ae22c1e0-2022-4f6b-bdca-ce94901fbc6e",
    "totalRecipients": 2,
    "successCount": 2,
    "failedCount": 0
  }
}

​
Authorizations

​
Authorizations
string | header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

​
Body

Email data to send to multiple recipients
​
recipients
object[]
required
Array of recipient email addresses and names (maximum 100 recipients)
Maximum 100 recipients per request.
​
from
object
required
Sender email address (must be from a verified domain) and name
​
subject
string
required
Email subject line (max 998 characters). Required if not using templateId.Maximum length: 998Example: "Welcome to Our Platform!"
​
html
string
HTML content of the email. Required if not using templateId.Handlebars Template Variables:Use Handlebars syntax for template variables in your HTML. Variables are wrapped in double curly braces: {{variableName}}. Example:
<h1>Hello {{firstName}}!</h1>
<p>Your order #{{orderNumber}} has been shipped.</p>
<p>Total: {{orderTotal}}</p>
Provide the values for these variables in the dynamicData field (either at the root level for all recipients, or per recipient).Example:
html: "<p>Hello {{firstName}}! Sending this email via AutoSend.</p>"
​
dynamicData
object
Key-value pairs for template variable substitution (Handlebars syntax). Same data will be used for all recipients.Example:
dynamicData: {
  "name": "Valued Customer",
  "firstName": "Valued",
  "orderNumber": "ORD-12345",
  "orderTotal": "$99.99"
}
​
text
string
Plain text version of the emailExample: "Welcome! Thanks for signing up."
​
templateId
string
ID of the email template to use. Required if not providing html/text.Example: "A-abc123"
​
replyTo
object
Reply-to email address and name
​
unsubscribeGroupId
string
ID of the unsubscribe groupExample: "unsub_group_123"
​
trackingClick
boolean
Enable or disable click tracking for links in the email. When enabled, links are rewritten so clicks can be tracked. If omitted, the project-level setting configured in your AutoSend dashboard is used.Example: false
​
trackingOpen
boolean
Enable or disable open tracking for the email. When enabled, a tracking pixel is added to record opens. If omitted, the project-level setting configured in your AutoSend dashboard is used.Example: false
​
headers
object
Custom email headers to include with the message as key-value pairs. Applied to every recipient in the batch.
  • Maximum 20 custom headers per email.
  • Header names must match ^[A-Za-z0-9-]{1,76}$ (ASCII letters, digits, and hyphens, up to 76 characters).
  • Header values can be up to 1000 characters.
  • Reserved headers managed by AutoSend or the underlying mail transport cannot be overridden, including: From, To, Cc, Bcc, Subject, Date, Message-ID, Return-Path, Sender, Reply-To, Received, DKIM-Signature, MIME-Version, Content-Type, Content-Transfer-Encoding, List-Unsubscribe, List-Unsubscribe-Post, X-SES-Configuration-Set, and X-SES-Message-Tags.
Example:
headers: {
  "X-Entity-Ref-ID": "order-12345",
  "X-Campaign-ID": "welcome-series"
}

​
Response

Bulk send completed
​
success
boolean
Indicates if the request was successfulExample: true
​
data
object