Send batch 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 yet.


Body Params

Email batch details

string
required
string
content
required
attachments
array of objects
length between 1 and 50
attachments

string
required
string
required
string
required
length ≤ 15728640
metadata
object
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