Send batch marketing emails

Send a batch of marketing emails.

Recipes
📧
Send a batch of marketing emails
Open Recipe

📢

Public preview

This feature is in Public preview and should be considered a beta feature. It may be subject to service disruption and short notice changes or improvements.



Consent and contact creation

Email marketing status is checked for known email addresses, and the email is not sent if the email address is unsubscribed or otherwise suppressed.

❗️

You must ensure you have email marketing consent for sends

If we don't recognize the email address sent to, we create a contact and set the email channel to subscribed. It's important therefore that you only attempt to send to email addresses that you have an email consent for.

List-unsubscribe

We include the List-unsubscribe tag in the technical header of all marketing emails sent through this endpoint; you don't need to add it.

Personalization fields

When using a triggered email template to provide the content of the email you can optionally provide overrides to any existing contact data fields in the personalizationValues array. The overrides will be used to populate any personalization fields in the template just for that email and will not be retained on the contact.

This can be used to provide value for contact data fields for use in the email that may not have been synced to Dotdigital Marketing yet.


Body Params

Email batch details

Emails to send.

string
required

The email address to send the email to.

string

The From address for your email.


Note: The From address must already be added to your account. If not specified your account's default From address is used.

content
required
attachments
array of objects
length between 1 and 50

Any attachments as Base64 encoded string.

  • All attachment types are supported.
  • Maximum file size: 15 MB
attachments

Attachment file

string
required

The filename of the attachment.

string
required

The MIME type of the file.

string
required
length ≤ 15728640

The Base64 encoded bytes of the attachment file.

metadata
object

Any additional metadata to be associated with the email. This is included on any related webhooks for correlation purposes.

Responses

401

Unauthorized

Language
Credentials
Basic
base64
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json