# Set up Mandrill Integration

Before you begin, you will need the following:

* Mandrill Account (MailChimp Account with Mandrill Add-On)
* CrossEngage Account
* User data (including an email address)

## **Creating a New API Key** <a href="#creating-a-new-api-key" id="creating-a-new-api-key"></a>

A Mandrill API key allows CrossEngage to connect to your Mandrill account. To create the API key:

* [*Log in*](https://mandrillapp.com/login/?referrer=%2F) to your Mandrill account.
* Select `Settings` from the left panel menu.
* Click the `+New API Key` button under the "API Keys" heading.

<figure><img src="https://985110910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hio8LJewN8lQY2Vlqy0%2Fuploads%2FEjNhJo0PzIMBgFwBIbxl%2FMandrill_APIKey.png?alt=media&#x26;token=56f6a255-e355-4871-91a1-f6612c84a330" alt=""><figcaption></figcaption></figure>

* To make the API Key easily identifiable, name it descriptively in the "Description" field.
* Keep the following deselected:
  * **Only Allow The Key To Work From Certain IP Addresses** - This limits where this key will work from.&#x20;
  * **Only Allow This Key To Use Certain API Calls** - This limits the API calls that can be made with this key.
* **Test Key** allows you to test Mandrill without sending real messages to users. Keep this deselected for your live account (but select this when making a Test API Key).
* Click `Create API Key`.

<figure><img src="https://985110910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hio8LJewN8lQY2Vlqy0%2Fuploads%2FwJcbuNF3yjsyNo7pWwsh%2FMandrill_APIKey_details.png?alt=media&#x26;token=d1cd90b8-ffbe-4637-bf59-707d19b28e82" alt=""><figcaption></figcaption></figure>

* Copy the new API Key - it will be used later for the integration.

{% hint style="info" %}
To create a Test API Key which allows you to test your CrossEngage setup follow the same steps as above but select the `Test Key` option.
{% endhint %}

## Configuring a Mandrill Integration in CrossEngage

* In the CrossEngage app, navigate to `Settings` > `Integrations`.
* Click the `Add new integration` button in the top right corner of the page.

<figure><img src="https://985110910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hio8LJewN8lQY2Vlqy0%2Fuploads%2FAgS47R9XoM50Wg0ysO8G%2FIntegrations_new.png?alt=media&#x26;token=f0b23923-4d5f-4b08-85d8-b97df995be9f" alt=""><figcaption></figcaption></figure>

* Search for Mandrill, then click `Set up`. An integration set-up form will open.

<figure><img src="https://985110910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hio8LJewN8lQY2Vlqy0%2Fuploads%2Fv6NXYnzGyJAvKo3Hb5Lm%2FIntegrations_Mandrill.png?alt=media&#x26;token=5ba9a0b5-982b-4d83-8496-e3be5d1d5382" alt=""><figcaption></figcaption></figure>

* Enter a clear, descriptive name for your integration in the "Account name" field.
* Paste the API key that you copied from your Mandrill account during the previous steps into the "Mandrill API key" field.
* If you wish, you can add:
  * **Inline CSS** that enables sending CSS in a HTML message. Messages must be less than 256KB. Read more about this option under the Inline CSS section in the[ Getting Started with Templates](https://mandrill.zendesk.com/hc/en-us/articles/205582507-Getting-Started-with-Templates) Mandrill guide.
  * **Use specific subaccount or IP pool** - You can find out more about using IP Pools [here](https://mandrill.zendesk.com/hc/en-us/articles/205582337-Should-I-use-a-dedicated-IP-). If you want to enable this you will be prompted to select your Mandrill account, as well as the specific IP pool that will be used.

{% hint style="info" %}
Using subaccounts you can send emails on behalf of others, or operate multi-tenant systems to separate sending for different users (besides using tags or metadata, for example). With subaccounts you can separate reputation, activity, reports, and quotas for different types of senders in a single Mandrill account.
{% endhint %}

* When ready, click `Apply` to save the integration.

<figure><img src="https://985110910-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hio8LJewN8lQY2Vlqy0%2Fuploads%2FbbdJCqRVPeDWzUAELqTI%2FIntegrations_Mandrill_Form.png?alt=media&#x26;token=1d516c2e-392a-4702-a2d4-099ffdd058ac" alt=""><figcaption></figcaption></figure>