Mandrill integration allows you to send emails through this provider using Bloomreach Engagement’s standard emailing mechanism.
Mandrill availability in BETA
This feature is currently available in the **BETA version,** but we are working on its improvement.
## Setup process
**1. Create an [account](🔗).**
You can also use an existing mandrill account, although we recommend to set up an account dedicated to Bloomreach Engagement. The reason is that once fully configured, Mandrill will send webhooks (with status updates) to Bloomreach Engagement for every email sent via the used account - which may have implications for both privacy and performance.
**2. 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 Bloomreach Engagement needs is: Users / Ping, Messages / Send.
For best experience we also recommend full permission for Webhooks.
**3. Add Mandrill Integration.**
In Bloomreach Engagement, go to `
Data and Assets > Integrations > Add new integration` and choose Mandrill.
If you did not restrict Webhook permissions for the API key, we recommend letting Bloomreach Engagement handle webhooks automatically. Please consult our support if you did or encountered any errors when saving your settings.
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 Bloomreach Engagement campaigns to send signed emails from your own domains using Mandrill.**
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.
After Integrating with Mandrill, you can look at [Default email settings](🔗) in order to change it to your default email integration.