Skip to main content
POST

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
object[]
required
Array of recipient email addresses and names (maximum 100 recipients)
Maximum 100 recipients per request.
object
required
Sender email address (must be from a verified domain) and name
string
required
Email subject line (max 998 characters). Required if not using templateId.Maximum length: 998Example: "Welcome to Our Platform!"
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:
Provide the values for these variables in the dynamicData field (either at the root level for all recipients, or per recipient).Example:
object
Key-value pairs for template variable substitution (Handlebars syntax). Same data will be used for all recipients.Example:
string
Plain text version of the emailExample: "Welcome! Thanks for signing up."
string
ID of the email template to use. Required if not providing html/text.Example: "A-abc123"
object
Reply-to email address and name
string
ID of the unsubscribe groupExample: "unsub_group_123"
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
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
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:

Response

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