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 Mandrill API key allows CrossEngage to connect to your Mandrill account. To create the API key:

  • Log in to your Mandrill account.

  • Select Settings from the left panel menu.

  • Click the +New API Key button under the "API Keys" heading.

  • 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.

    • 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.

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

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.

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.

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

  • 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 Mandrill guide.

    • Use specific subaccount or IP pool - You can find out more about using IP Pools here. 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.

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.

  • When ready, click Apply to save the integration.

Last updated