The Mandrill provider (Mailchimp Transactional Email) enables you to deliver professional transactional emails to your customers through the Comify Platform. With a single API integration, you can create seamless multi-channel communication experiences.

Getting Started

Implementing the Mandrill email provider requires three primary steps: creating a Mandrill account, generating a Mandrill API key, and configuring the Mandrill integration within your Comify platform.

Creating a Mandrill Account

Follow these steps to set up your Mandrill account:

  1. If you already have a Mailchimp account with a Standard plan or higher, you can enable Mailchimp Transactional (formerly Mandrill) from the Monthly plans or credits page.
  2. If you don’t have a Mailchimp account, visit Mailchimp’s official website and select “Sign Up Free”.
  3. Enter all required information to create your account.
  4. Complete the security verification process for both your email address and phone number.
  5. Once verification is complete, upgrade to a Standard plan or higher to access Mailchimp Transactional features.
  6. Navigate to the Transactional Email section in your Mailchimp dashboard to set up your sending domain.

Creating a Mandrill API Key

Follow these steps to generate and secure your Mandrill API key:

  1. Navigate to the Settings of your Mailchimp Transactional account.
  2. Look for the API Keys section and click “Create New Key”.
  3. Assign a descriptive name to your key (e.g., “Comify Integration”) for easy identification.
  4. Copy the generated key immediately and store it in a secure location. Important: For security purposes, you won’t be able to see or copy the key once you finish generating it.
  5. Remember that your Mandrill API key provides full account access, so keep it secure, as you would a password.

Creating a Comify API Key

Before configuring the Mandrill integration, you’ll need to generate a Comify API key for authentication:

  1. Access your Comify account dashboard.
  2. Navigate to the API Keys management section at https://cloud.comify.io/settings/api-keys.
  3. Select “Generate API Key” if not already generated.
  4. Provide a clear, descriptive name for your key (e.g., “Mandrill Integration”) to facilitate future management.
  5. Copy and store this API key in a secure location. You’ll use this key in your application code to authenticate requests to the Comify platform.

Configuring Mandrill Integration in Comify

To establish the connection between Comify and Mandrill:

  1. Sign in to your Comify platform dashboard.
  2. Navigate to Integration Store > Add Integration > E-mail.
  3. From the available email service providers, select Mandrill.
  4. Enter the Mandrill API key you generated earlier.
  5. Configure any additional provider-specific settings according to your requirements.
  6. Click Save to finalize the integration.

Creating Email Templates

After successfully configuring the Mandrill integration, you can design email templates directly within the Comify platform:

  1. Navigate to the Manage Templates section in your Comify dashboard.
  2. Select the Email tab from the available channel options.
  3. Click Create Template to begin the design process.
  4. Choose from multiple template creation methods based on your preference and skill level:
    • AI-Assisted Design: Utilize the AI Writer feature in the Email Editor section for automated content generation.
    • Manual HTML Editing: Select Switch to HTML in the Email Editor for direct code editing.
    • Import Existing Templates: Use the Chrome extension to copy HTML from existing templates for reuse in Comify.

Sending Email Templates

Implement the following code examples in your application to trigger email template delivery:

const { Comify } = require('comify-node')

const comm = new Comify('COMIFY_API_KEY')

comm.triggerComm('email_template_name',{ 
  "order_id" : "123455",
  "billing" : {
    "customerEmail" : "contact@comify.io",
    "customerName" : "Comify"
  }
}, 'email')

Upon successful API request processing, you will receive a response containing a unique requestId and confirmation message:

{
  "requestId": "016e9d9c-ea29-455c-bf2e-a703e96482fb",
  "message": "your request has been submitted"
}

Important: The API may return a success response even when there are underlying issues with your request. For comprehensive delivery monitoring and troubleshooting, we recommend reviewing the complete request logs in the Activity Feed dashboard.