Mailchimp

Connect Sequensy to Mailchimp for email marketing automation.

Overview

The Mailchimp integration allows you to automatically manage subscribers, add tags, and sync customer data with your Mailchimp email lists.

Setup

Getting Your API Key

  1. Log in to your Mailchimp account
  2. Go to Profile > Extras > API keys
  3. Click Create A Key
  4. Copy the generated API key

Connecting in Sequensy

  1. Go to Sequensy > Integrations
  2. Find Mailchimp and click Connect
  3. Paste your API key
  4. Click Save

The connection will be verified automatically.

Available Actions

Subscribe Contact

Add a new subscriber to a Mailchimp audience.

FieldTypeRequiredDescription
AudienceselectYesTarget audience/list
EmailstringYesSubscriber email
First NamestringNoSubscriber first name
Last NamestringNoSubscriber last name
TagsstringNoComma-separated tags
StatusselectNosubscribed, pending
Merge FieldsobjectNoCustom merge fields

Example:

Audience: Newsletter
Email: {{Trigger.user_email}}
First Name: {{Trigger.first_name}}
Last Name: {{Trigger.last_name}}
Tags: website-signup, {{Trigger.source}}
Status: subscribed

Unsubscribe Contact

Remove a subscriber from an audience.

FieldTypeRequiredDescription
AudienceselectYesTarget audience
EmailstringYesEmail to unsubscribe

Add Tags

Add tags to an existing subscriber.

FieldTypeRequiredDescription
AudienceselectYesTarget audience
EmailstringYesSubscriber email
TagsstringYesTags to add

Remove Tags

Remove tags from a subscriber.

FieldTypeRequiredDescription
AudienceselectYesTarget audience
EmailstringYesSubscriber email
TagsstringYesTags to remove

Update Subscriber

Update subscriber information.

FieldTypeRequiredDescription
AudienceselectYesTarget audience
EmailstringYesSubscriber email
Merge FieldsobjectNoFields to update
TagsstringNoNew tags

Common Workflows

New User to Newsletter

Trigger: User Registered
Action: Mailchimp - Subscribe Contact
  Audience: Newsletter
  Email: {{Trigger.user_email}}
  First Name: {{Trigger.first_name}}
  Tags: new-member

Customer Segmentation

Trigger: Order Completed
Action: Mailchimp - Add Tags
  Email: {{Trigger.billing.email}}
  Tags: customer, purchased-{{Trigger.items[0].category}}

VIP Tagging

Trigger: Order Completed
Condition: Order total > 200
Action: Mailchimp - Add Tags
  Email: {{Trigger.billing.email}}
  Tags: vip-customer, high-value

Unsubscribe on Cancellation

Trigger: Subscription Cancelled
Action: Mailchimp - Unsubscribe Contact
  Email: {{Trigger.user_email}}

Merge Fields

Mailchimp merge fields let you store custom data. Common fields:

Merge TagDescription
FNAMEFirst name
LNAMELast name
PHONEPhone number
BIRTHDAYBirthday
ADDRESSMailing address

Update merge fields:

Merge Fields:
  FNAME: {{Trigger.first_name}}
  LNAME: {{Trigger.last_name}}
  COMPANY: {{Trigger.company}}

Best Practices

  • Use double opt-in for GDPR compliance
  • Segment with tags for targeted campaigns
  • Keep subscriber data synchronized
  • Clean up inactive subscribers regularly

Troubleshooting

Subscriber not added

  • Verify email format is valid
  • Check if already subscribed
  • Ensure audience has available capacity

Tags not applying

  • Verify subscriber exists
  • Check tag spelling (case-sensitive)
  • Ensure tags are comma-separated

API errors

  • Verify API key is correct
  • Check Mailchimp account status
  • Review Mailchimp’s API limits