Mandrill is a transactional email platform built by Mailchimp that can be used for one to one messages that are triggered by certain events. Typical transactional emails are reset password emails, receipt emails and welcome to the service emails. You can read more about Mandrill here.


Mandrill setup

  1. Add a Mandrill plan to your already existing Mailchimp plan

  2. Create a Mandrill API Key and then add in the config section of the Magine Pro Console. Rember to activate the key and to give it full permissions.

  3. You can now create templates for sending transactional emails. The easiest way is to create the template in MailChimp and then export it to Mandrill. Read more here.

  4. When you create a template you will add a Template slug. This slug is used to identify which template should be used by our trigger. The name of your template in MailChimp will be the slug in Mandrill. Choose the naming wisely as you can't change the slug after the template was created in Mandrill. Check the table below if you can choose the slug freely or if it has to be a specific one.

  5. If you have several translations for a template you should use the same slug, but add “_{language}” as a suffix. E.g. “welcome_en” will be the English translation and “welcome_es” will be the Spanish translation while “welcome” will be the default.

  6. Then add the slug in the config section of the Magine Pro Console.


Supported Mandril templates

These are the different types of emails that we support at the moment.


TemplateDescription/TriggerSlugHardcoded slug
WelcomeSends a welcome email to all registered users when the user is created in the serviceSuggestion: welcomeNo
Reset PasswordSends an email to users with a reset password link when the user clicks on forgot my passwordSuggestion: reset-passwordNo
Set PincodeIf parental control is enabled, customers can request a new pin code when they click on "Forgot my pin code"
The email is automatically sent when registering an account if forced parental control is enabled
Suggestion: set-pincodeNo
Welcome with PincodeThis email will send a pin code to a user when they register a new account and parental control is enabled in the service.Suggestion: forced-pincodeNo
Subscription confirmationEvery time a user purchases an offer this email is sent to confirm the purchaseSuggestion: subscription-confirmationNo
Forced downgrade warningWhen a recurring transaction fails the 1st Or 2nd time this email is sent to users to let them know that payment has failed and that they need to check their payment method.Has to be: dunning-reminder-{partner}-{locale}Yes
Forced downgrade confirmationWhen a recurring transaction fails the 3rd time this email is sent to inform users that they have lost their access to the offerHas to be: dunning-downgrade-{partner}-{locale}Yes


Design help for transactional emails

When you design transactional emails you will need to add specific placeholders so that your customers are getting the correct information automatically. When you connect the template with our system through the console our backend will fill up these placeholders.

  • Reset password: Please embed this link https://YOURSERVICEURL/reset-password/*|code|* in your email template
  • Parental control code: Please embed this placeholder *|pinCode|* to show the Pincode to your customers.
  • User name: If you would like to address your customers by name please add this condition *|IF:name|* *|END:IF|*

Mandrill gives you even more options to embed personalised content. Please read here for further instructions.


If the emails aren't triggered start your troubleshooting here.