Send bulk e-mail plugin
This plugin sends bulk email via ElasticEmail API.
Requirements
You'll need a ElasticEmail account to use this plugin. Then you'll need to generate API key
ElasticEmail requires a domain configuration to send e-mails, you'll need to add and configure your domain in ElasticEmail settings. Please refer to ElasticEmail documentation for details.
The last thing is your ElasticEmail plan - if you're on the trial version, you are able to send emails only within your own domain, so if your email is [email protected], then your domain is simply example.com and you can send messages only to emails ending with example.com.
To get rid of this restriction, you need a paid plan on ElasticEmail.
Input
This plugin takes any payload.
Output
This plugin returns a response from ElasticEmail API. Depending on the response result it will trigger ether payload port (if the response is successful) or error for if the response indicates that the e-mail was not sent.
Config
Plugin's configuration requires information about API key, sender email, message recipient's email(s), message subject and message content.
{
"source": {
"id": "<id-of-your-elastic-email-resource>",
"name": "<name-of-your-elastic-email-resource>"
},
"sender_email": "[email protected]",
"message": {
"recipient": "payload@email",
"content": {
"type": "text/html",
"content": "Message body"
},
"subject": "subject"
}
}
ElasticEmail resource
ElasticEmail token must be stored in Tracardis resources. Please remember to provide both test and production API key (token) in resource configuration.
ElasticEmail API Tokens can be found in settings -> SMTP & API Info on It is a string with random characters.
Sender's e-mail
That's the email that you want to send emails from. It has to end with one of your domains registered in ElasticEmail. For instance, if your shop is exampleshop.com, then you may want to send emails from an address like [email protected], and then that's the value that you want to insert into plugin configuration. Please notice that this address does not have to exist.
Message recipient's email
This is the destination email or emails. It can be in form of dot path to email address (for example [email protected]). You can also insert the address itself. Please notice that merged profiles can have multiple values in one field - if John Doe has two or more email addresses in his profile, then plugin will send the message to all of them.
Message subject
That's message subject, if you type in payment, then recipient of the message will see payment as the subject of received message.
Message content
You can select if your content should be HTML or just plain text. You can also use templates for your emails - both in HTML and text format.
Examples:
Example 1 - plain text
Hello {{[email protected]}}, your order will be dispatched in next two days.
This message will have the {{[email protected]}} changed to the current profile's name, so John Doe will see 'Hello John, your order will be dispatched in next two days.' in his message.
Example 2 - HTML
<h1>Hello {{[email protected]}}!</h1>
<p>Thanks for visiting our website on {{[email protected]}}!</p>
<p style="color:red">To thank you, we send you a photo of cute dog. Enjoy:</p>
<img src="<url-to-photo-of-cute-dog>"/>
Tip
On ElasticEmail site, you can turn on the test mode after clicking on you username in up-right corner. In the test mode, you can generate test API key. You can use it in Tracardi for test purposes - messages won't be sent, but ElasticEmail will act like they are, so you can test your configuration without being charged a single cent.