Transactional email
You can send real-time transactional emails using our communications functionality in the API.
Features include:
- The content of the transactional email can be HTML and/or plain text based
- Use triggered templates to send transactional email
- Data merge using data passed in the API call
- Bulk methods for high volume sending
- Attachment support
- Feedback via webhooks
Ways of sending transactional email
We offer a range of ways to send transactional emails from built in functions in our integrations and a variety of API and protocol based methods, such as:
API based
Use our Transactional Email API to send transactional email individually or in bulk using explicit content or triggered templates with data merge. Check out the following methods to learn more, Transactional Email API
SMTP based
Use SMTP to send transaction email using your favourite email tools and or libraries; the full process is explained in our guide here
Send limits
Calls to the Transactional Email API do not count towards your API call rate limits, however by default you are limited to 50,000 per UTC calendar day. Contact your Customer Success representative if you need more capacity per day.
Receiving status updates
If you wish to receive status updates on your transactional email sends you can do via our Webhooks is near real-time. You can optionally subscribe to the following event types:
- message.sent - Sent whenever you successfully send a transactional email
- message.delivered - Sent when we know a message is delivered, and is inferred from when the email is read
- message.read - Sent when a message is read / opened
- message.failed - Sent if there is a terminal problem processing your email send
- complaint.received - Sent if a recipient of your transactional email complains about the email. We recommend reacting to these and ensuring you do not send further emails to this recipient.
- interaction.click - Sent whenever a recipient clicks on a tracked link within your emails. Use a triggered campaign based Transactional Email to add tracked links to your emails.
Use individual email sends if you want granular tracking
Due to the nature of email we can only track events such as sent, delivered, read and clicked down to the transactional email request, therefore if you want these events for each recipient then please only send to a single email address per transactional email request. You can use our batch transactional email API methods to send large collections of emails efficiently.
Keep your email recipients up to date
When using transactional email it is important to ensure your recipients are maintained to ensure email is not sent to recipients who are not expecting or wanting it, to old invalid email addresses, or to recipients who have complained. Failure to keep your recipients maintained causes deliverability issues for your email and may require you to use your own dedicated IPs in order to continue to use the service.
To help maintain your recipients automatically we strongly recommend implementing our webhooks and sending to individuals. If you receive a webhook event for the following you should remove the recipient from any future sends:
- A message.failed event with a status of "Hard bounce", as this indicates the email address is no longer valid.
- A complaint.received event, as this indicates that the recipient has made a complaint about receiving the email and therefore should be opted out of future sends.
Making events easier to correlate and process
When sending your transactional email messages using the Transactional Email API you can optionally
- specify metadata
- specify tags can to be added in the API request
- use campaign tags associated with a triggered campaign template.
We include this metadata and any tags in the webhook events related to the transactional email. By including your own keys and data you can make it far easier to process the received webhook events by avoiding the need to perform a lookup prior to processing potentially.
Template based transactional email
Users of Dotdigital can create a transactional email template as a triggered campaign in EasyEditor.
It then needs to be sent either via SMTP, or via our API; see:
- Send transactional email using a triggered campaign
- Send batch transactional email using a triggered campaign
- Sending transactional email using SMTP
The numeric campaign ID is used in the call to identify the triggered campaign to send as a transactional email.
Personalisation can also be used in the transactional email template by adding placeholders such as @FIRSTNAME@ in the triggered campaign in Dotdigital.
The personalisation values are then supplied either in the SMTP headers or in the API call's parameters. These take the form of key-value pairs.
Unsupported EasyEditor building blocks and links
Transactional email templates don't support the following EasyEditor building blocks and link types:
- RSS feed
- Sharing
- Social links
- Dynamic content
- External dynamic content
- Advanced personalisation blocks
- Unsubscribe link - but you must include one in order to save your template in EasyEditor; read 'About unsubscribe links' in our 'Creating and designing a transactional email template' support article.
- View in browser link
- Double opt-in link
A note on HTML compatibility for personalisation content
When making use of transactional email personalisation, the type of personalised content needs to be compatible with the HTML element it's being put into in EasyEditor. For example, if your code contains a personalised table, it must go into a table element in the template, not a paragraph.
Check with your campaign designers to ensure that their campaign's elements are suitable for the personalisation content being used.
Monitoring transactional email
You can monitor and analyse the usage of the transactional email system in the Analytics area of Dotdigital. In-app, you can also:
- Download messages
- View complaints
- Configure usable from addresses, and request new ones
- Configure link tracking
- Set up SMTP credentials
Avoiding deliverability issues
It is important that only transactional style emails and not marketing are sent using the Transactional Email API, and the recipient is expecting to receive the email, as opt out checks are not automatically applied. We recommend if you receive a complaint.received webhook event that you stop sending email to this recipient immediately, as the complaints damage the reputation and therefore deliverability of emails of the domain and IP address the email was sent from.
You can also view received complaints with regards to transactional email in Dotdigital.
To do this:
- Expand the User menu in the bottom left and select Settings.
- Go to Transactional email > Complaints.
Do not ignore complaints
If you are receiving complaints you must ensure that you stop emailing these recipients, and if you receive many complaints please review your emails contents to see if it:
- Is transactional in nature i.e. informative, an update on a service or purchase the recipient has used/done
- Is expected, you informed the recipient that you would be sending the emails
If too many complaints are received then we may withdraw your use of the Transactional Email API, and complaints are continually monitored by our deliverability team.
Learn more about transactional email
For an overview on transactional email, check out our Help centre article .
Updated about 1 year ago