- Create an account at https://mandrill.com/signup/
You can also use an existing mandrill account, although we recommend to set up an account dedicated to Exponea. The reason is that once fully configured, Mandrill will send webhooks (with status updates) to Exponea for every email sent via the used account – which may have implications for both privacy and performance.
- Create a new API key at https://mandrillapp.com/settings/index
Use the New API Key button to create a new key (all options left at default, you may provide a description); then grab the Key string
We recommend not to restrict API calls allowed for this key. If you decide to do so, the minimal set of calls Exponea needs is: Users / Ping, Messages / Send.
For best experience we also recommend full permission for Webhooks.
- In Exponea, go to project Settings (from the project Overview screen) → Emails → Use your own mandrill account → fill in the API key → Save
If you didn’t restrict Webhook permissions for the API key, we recommend to let Exponea Handle webhooks automatically. If you did or if you encounter any errors when saving your settings, please consult our support.
- In order to send signed emails from your domain head back to Mandrill → Domains / Sending Domains → add your domain name
- Mandrill will then guide you through the following steps:
- Verifying your domain (by sending a verification email to any email address located at this domain)
- Setting up DKIM – DomainKeys Identified Mail (by adding the generated TXT domain record to mandrill._domainkey.example.com)
- Setting up SPF – Sender Policy Framework (by adding the generated TXT domain record to @.example.com)
The latter two require changing the DNS zone files, which requires permissions for your domain registration and can be rather technical. Please follow the guide Mandrill links to if you are not sure how to do this or consult your technical staff.
Please be aware that it may take some time (usually up to an hour, but could potentially be much longer) for Mandrill to fully verify the DNS records.
You can now use Exponea campaigns to send signed emails from your own domains using Mandrill.
Note: It is also possible to override the Return Path domain (displayed in GMail as mailed-by). Although not necessary, you can follow the steps in this article if you wish to do so: https://mandrill.zendesk.com/hc/en-us/articles/205582727-Can-I-customize-the-Return-Path-bounce-address-used-for-my-emails-