DEV

Mailchimp

Mailchimp Connection

Put Mailchimp to Work with @Human Automations and @Human Agents

The Mailchimp Connection documents all Triggers, Actions and Query Operations available for creating automations via the Mailchimp API.

What can you do with the Mailchimp Connection?

  • Connect to the Mailchimp API in a few clicks

  • Use the related Mailchimp Operations (see below) in @Human Automations or @Human Agents

Trigger Operations

Audience Created

Triggers on: lists/list_created

Triggered when a new audience (list) is created in Mailchimp.

Audience Updated

Triggers on: lists/list_updated

Triggered when an existing audience (list) is updated in Mailchimp.

Contact Subscribed

Triggers on: members/member_subscribed

Triggered when a contact subscribes to a Mailchimp audience.

Contact Unsubscribed

Triggers on: members/member_unsubscribed

Triggered when a contact unsubscribes from a Mailchimp audience.

Contact Profile Updated

Triggers on: members/member_profile_updated

Triggered when a contact's profile information is updated in a Mailchimp audience.

Campaign Sent

Triggers on: campaigns/campaign_sent

Triggered when a Mailchimp campaign is sent.

Email Sent

Triggers on: events/email_sent

Triggered when an individual email is sent as part of a campaign.

Email Opened

Triggers on: events/email_opened

Triggered when a recipient opens a campaign email.

Email Link Clicked

Triggers on: events/email_clicked

Triggered when a recipient clicks a link in a campaign email.

Email Bounced

Triggers on: events/email_bounced

Triggered when a campaign email bounces for a recipient.

Email Marked as Spam

Triggers on: events/email_spam

Triggered when a recipient marks a campaign email as spam.

Action Operations

Action: Add Member

Action: Update Member

Action: Add/Update (upsert) Member

Action: Delete Member

Action: Add an Event

Query Operations

Query: Get Lists

Query: Get List Details

Query: List Members

Query: Get Campaigns

Query: Get Campaign Details

Query: Get List Member Activity Feed

Example link

Obtaining Access Credentials

To obtain a Mailchimp Personal Access Token (PAT) for system-to-system access, follow these steps:

Prerequisites

  • A Mailchimp account (Free or Paid).

  • Admin access to the Mailchimp account.

Steps to Generate a PAT

  1. Log in to your Mailchimp account.

  2. Click your profile icon (top-right) → Account.

  3. Navigate to ExtrasAPI keys.

  4. Under Your API keys, click Create A Key.

  5. (Optional) Enter a name for the key (e.g., "System Integration").

  6. Click Generate Key.

  7. Copy the generated API key (this is your PAT).

Permissions

  • The PAT inherits the permissions of the user who generated it.

  • Ensure the account has the necessary audience, campaign, or automation access as required.

Provide the generated PAT securely for system integration.

Configuring Webhooks

  1. Log in to your Mailchimp account.

  2. Click the Audience icon in the sidebar.

  3. Click All contacts.

  4. If you have more than one audience, click the Current audience dropdown and choose the one you want to work with.

  5. Click the Settings dropdown and select Webhooks.

  6. Click the Create New Webhook button.

  7. In the Callback URL field, enter the URL where you want to receive webhook data.

  8. Select the checkboxes for the events and sources that should trigger the webhook.

  9. Click Save.

Code (Apache v2.0): Service Connectivity and Metadata

Code (Apache v2.0): List of External Resources and Internal Mapping

Last updated