Adding transactional recipients to a subscriber list

When creating a smart transactional email, you can optionally add the transactional recipients to a subscriber list in your account. To comply with permissions-based email marketing, there are only two situations where doing this is acceptable:

  • The recipient has explicitly expressed permission to be sent promotional emails by opting-in at the time of triggering a transactional email.
  • The recipient has just completed a purchase from your website or application.

If a user triggers a different type of transactional email, such as a password reset, account confirmation or otherwise, they have not opted-in to a mailing list, and therefore cannot be added to that list as per our anti-spam policies.

Add to a subscriber list with smart transactional email

If you have one or more subscriber lists in your account, you'll see an option during the creation of your smart transactional email to "Add recipients to a list," as shown here:

This solely selects a list — to add a transactional recipient to the chosen list, you or your developer will have to pass AddRecipientsToList as true when making the API call to send a smart transactional email.

Add to a subscriber list with classic transactional email

To add transactional recipients to a subscriber list with classic transactional email, you'll first need the apropriate list's ID. To retrieve it, open the subscriber list of your choice, and click change name/type under the list name. The list ID is found under the "API Subscriber List ID" section.

Add to a list via our API

Copy the list ID you retrieved above, then add the following to your API call:

AddRecipientsToList": "XXXXXX"

Where XXXXXX is the list ID you want to add the recipient to.

Add to a list via SMTP

Copy the list ID you retrieved above, then add the following to your SMTP header:

X-Cmail-AddRecipientsToList: XXXXXX

Where XXXXXX is the list ID you want to add the recipient to.