Jump to a Section

Overview

The first time you add a MailChimp card to a Flow, you need to set up a configuration for that connector. Setting up a configuration will allow you to connect the Designer to your MailChimp account, save the information, and reuse that configuration the next time you build a Flow using MailChimp. You can set up and save multiple configurations and share them with your teammates. Here’s how to set up a new configuration in MailChimp:

  1. Click “+Add Account” on the MailChimp card.
  2. Give your account a recognizable nickname such as “My MailChimp Account” and click “Next”.
  3. In the popup window, enter your login information and click “Login”.
  4. On the next window that appears, select “Allow”. You will then automatically be redirected back to the card.

And your configuration is complete!

    Events

    • Monitor New Members in List

      This event will trigger your Flow when a new member has been added to a given list.

      Options

      • Your list (dropdown list): The list you would like to monitor. This list is dynamic, and will display any list that you have associated to the given MailChimp account.

      Output Fields

      This group of outputs will be sent out for each new member that is added to your list. The available fields here may also include custom fields for each member associated to the monitored list. Below is a list of the default output fields, but you may have more.

      • Email Address (text): The email  address associated to the new member added to your list.
      • Unique Email ID (text): The identifier for the address across all of MailChimp.
      • Email Type (text): The type of email this member asked to receive (‘html’ or ‘text’).
      • Status (text): The subscriber’s current status. Possible Values: subscribed, unsubscribed, cleaned, pending, or transactional.
    • New Subscriber

      New Subscriber

      Monitors MailChimp for updates and runs the Flow once for each new subscriber.

      Output Fields

      • Subscriber

        • Subscriber ID (text): The unique MailChimp ID for the new subscriber.

        • List ID (text): The unique MailChimp ID for the email list they’re in.

        • Email Address (text): Subscriber’s email.

        • Email ID (text): Unique ID for this email address across all of MailChimp.

        • Email Type (text): Type of email the subscriber asked for, either “html” or “text”.

        • Merge Fields (object): These are the values you store for each contact and the tag names to access them. For example, new lists by default have fields for First Name and Last Name using the tags FNAME and LNAME. These are customized in MailChimp using the ”List fields and |MERGE| tags” feature. To access these values so you can use them later in your Flow, send the Merge Fields object to the input of a Get Multiple then click to create new Get Multiple outputs named using the exact tag names you wish to get values for, e.g. FNAME, LNAME and whatever other tags you defined in MailChimp.

        • Status (text): Subscriber’s current status, either: subscribed, unsubscribed, cleaned, pending, or transactional.

        • Email Client (text): The subscriber’s email client.

        • Signed Up At (text): The date and time the subscriber signed up.

        • Opted In At (text): The date and time the subscriber confirmed their opt-in status.

        • Language (text): The subscriber’s language (if set or detected).

      • Location

        • GMT Offset (number): The time difference in hours from GMT.
        • DST Offset (number): The offset for timezones where daylight saving time is observed.
        • Country Code (text): The unique country code for the location country.
        • Timezone (text): The timezone.
      • Context

        • Execution ID (text): The execution ID of the Flow that ran for this contact. Can be used for error handling purposes.
    • Updated Subscriber

      This event will trigger your Flow when a subscriber has been updated.

      Output Fields

      These outputs will be available for each subscriber that is updated.

      • Subscriber
        • Subscriber ID (text): The ID of the subscriber.
        • Email Address (text) : The email address for a subscriber.
        • Email ID  (text) : An identifier for the address across all of MailChimp.
        • Email Type  (text): Type of email this subscriber asked to get (‘html’ or ‘text’).
        • Status  (text):  The subscriber’s current status. Possible Values: subscribed, unsubscribed, cleaned, pending, or transactional.
        • Merge Fields (object): An individual merge variable and value for a subscriber.
        • Avg Open Rate (number): A subscriber’s average open rate.
        • Avg Click Rate (number): A subscriber’s average clickthrough rate.
        • Language  (text): If set/detected, the subscriber’s language.
        • Email Client  (text): The list member’s email client.
        • Signed Up At  (text): The date/time the subscribed initially signed up.
        • Opted In At  (text) : The date/time the subscriber opted into the service at.
        • Last Updated At  (text): The date/time the subscriber was last updated.
      • Location
        • GMT Offset (number): The time difference in hours from GMT.
        • DST Offset (number): The offset for timezones where daylight saving time is observed.
        • Country Code  (text): The unique code for the location country.
        • Timezone  (text): The timezone for the location.
      • Latest Note
        • Note ID (number): The ID of the latest note.
        • Created At (text): The date/time the latest note was created.
        • Created By (text): The author of the note
        • Note (text): The content of the note.

    Actions

    • Add Existing Member to Group

      Add Existing Member to Group

      Adds an existing member to a group within a MailChimp list.

      Options

      • Your list (dropdown list): The name of your MailChimp email list.
      • Group Title (dropdown list): The category name for the group.
      • Group Name (dropdown list): The option within the group to add the new member to.
      • Options (dropdown list): Choose subscribed to add the member’s email immediately. Use pending to send a confirmation email. Unsubscribed or cleaned will add the email to an archive and prevent sending to that email address in the future.

      Input Fields

      • Email Address (text): Email you want to add to the group.

      Output Fields

      None

    • Add New Member to Group

      Adds a new member to a MailChimp list and also assigns them to a group. (If you just want to add them to a list, use Add New Member to List instead.)

      Note: The MailChimp API returns an error if the email is already in the list. To add an existing member to a Group, use the Add Existing Member to Group action.

      Options

      • Your list (dropdown list): The name of your MailChimp email list.
      • Group Title (dropdown list): The category name for the group.
      • Group Name (dropdown list): The option within the group to add the new member to.
      • Options (dropdown list): Choose subscribed to add the member’s email immediately. Use pending to send a confirmation email. Unsubscribed or cleaned will add the email to an archive and prevent sending to that email address in the future.

      Input Fields

      • Email Address (text): Email you want to add to the group.
      • Merge Fields (multiple fields): These are the custom fields for contacts that have been set up in MailChimp using the ”List fields and |MERGE| tags” feature. For example, new lists by default have fields for First Name and Last Name using the tags FNAME and LNAME.

      Output Fields

      None

    • Add New Members to List

      Add New Member to List

      Adds a new member to a MailChimp list.

      Note: The MailChimp API returns an error if the email is already in the list.

      Options

      • Your list (dropdown list): The name of your MailChimp email list.
      • Options (dropdown list): Choose subscribed to add the member’s email immediately. Use pending to send a confirmation email. Unsubscribed or cleaned will add the email to an archive and prevent sending to that email address in the future.

      Input Fields

      • Email Address (text): Email you want to add to the list.
      • Merge Fields (multiple fields): These are the custom fields for contacts that have been set up in MailChimp using the ”List fields and |MERGE| tags” feature. For example, new lists by default have fields for First Name and Last Name using the tags FNAME and LNAME.

      Output Fields

      None

    • GetUserInfoFromCampaign

      Get User Info From Campaign

      Returns information about a user in a campaign. NOTE: currently investigating a bug in this action that prevents some users from selecting Your Campaign. If you are seeing that error, please contact support – we are working on a fix we hope to have out soon.

      Options

      • Your Campaign (dropdown): Choose from a list of MailChimp campaigns.

      Input Fields

      • Email Address (text): The email address of the user you want information about.

      Output Fields

      • EmailAddress (text): Subscriber’s email.
      • UniqueEmailID (text): Unique ID for this email address across all of MailChimp.
      • EmailType (text): Type of email the subscriber asked for, either “html” or “text”.
      • Status (text): Subscriber’s current status, either: subscribed, unsubscribed, cleaned, pending, or transactional.
      • AvgOpenRate (text): Subscriber’s average open rate.
      • AvgClickRate (text): Subscriber’s average click rate.
      • IpSignup (text): IP address the subscriber signed up from.
      • TimestampSignup (text): The date and time the subscriber signed up for the list.
      • MemberRating (text): MailChimp’s star rating, between 1 and 5.
      • LastChanged (text): The date and time the subscriber’s info was last changed.
      • Language (text): The subscriber’s language (if set or detected), as a code like en for English. See MailChimp KB for a list of codes.
      • IsVIP (text): True or False, whether or not the subscriber has been marked as a VIP.
      • Email Client (text): The subscriber’s email client.
      • Country Code (text): The unique country code for the location country.
      • Timezone (text): The timezone.
      • LastNote (text): The most recent note added about this member.
      • ListId (text): The ID of the list.
      • Merge Fields (dynamically generate a list of fields): These are customized in MailChimp using the ”List fields and |MERGE| tags” feature. For example, new lists by default have fields for First Name and Last Name using the tags FNAME and LNAME.
    • Remove Email from List

      Removes an email from a MailChimp list.

      Options

      • Your list (dropdown list): The name of your MailChimp email list.

      Input Fields

      • Member
        • EmailAddress (text - required): Email you want to remove from the list.