Member

Member connects your flow to your Mailchimp account to work with the subscribers (members) of your lists: look them up, add them, change their details and status, delete them, and add or remove tags.

It is useful when subscribers come from somewhere else, such as a form, a store or a chat, and you want them to land in your Mailchimp list with their details and tags without doing it by hand.

When to use it

• Someone signs up for the newsletter on your website and you want to add them to your Mailchimp list.
• A customer changes their phone number or company in your system and you want to update it in Mailchimp too.
• A customer buys for the first time and you want to give them the customer tag to send them other campaigns.
• An AI agent needs to check whether an email is already subscribed before offering the newsletter.
• Someone asks you to delete their data and you want to remove them from the list.

Configuration

You need a Mailchimp API credential with the API key of your account. You find it in Mailchimp, on the API Keys page of your account. See Credentials.

Field	What it does
Credential (required)	The Mailchimp API credential used to access your account.
Operation	What the component does. See Operations.
List ID	The Mailchimp list (audience) you work with. When you pick the credential, the dropdown shows the names of your lists and selects the first one. You can also give the list’s ID.
Email	The subscriber’s email. Required in every operation except Get Members, where, if you leave it empty, all subscribers of the list are fetched.
Status	In Add Members and Update Members. The subscriber’s status: Cleaned, Pending (waiting to confirm their sign-up), Subscribed, Transactional or Unsubscribed. Default: Subscribed; choose the right one in each case. In Update Members the status is always sent, so check it.
Max Results	Only in Get Members. The maximum number of subscribers to fetch. Default: 10.
Tag Action	Only in Manage Member Tags. Add adds the tags and Remove removes them. Default: Add.
Tags	In Manage Member Tags, the tags to add or remove, one per item.

Operations

Operation	What it does
Get Members	Fetches one subscriber by email or the list of subscribers of the chosen list.
Add Members	Adds a new subscriber to the list. If the email is already in the list, the component returns an error.
Update Members	Changes the details or status of an existing subscriber.
Delete Members	Removes a subscriber from the list.
Manage Member Tags	Adds or removes tags on a subscriber.

Advanced options

Only in Add Members and Update Members. Each switch shows its fields when you turn it on; the data of a group is only sent if its switch is on.

Field	What it does
Include Fields	Turn it on to send the subscriber’s personal details.
Fields	The details you want to send: First Name, Last Name, Address, Phone, Birthday and Company. Each one shows its own field.
First Name, Last Name, Phone, Company	The subscriber’s first name, last name, phone number and company.
Birthday	The birthday, in MM/DD format, for example 03/25.
Address, City, State, Zip, Country	The address. If you pick Address in Fields, you must fill in all five fields.
Include Location	Turn it on to send the subscriber’s location in Latitude and Longitude.
Include Additional Fields	Turn it on to send other details about the subscriber.
Additional Fields	The additional details you want to send: Language, Tags, Email Type and VIP Status.
Language	The subscriber’s language, for example en.
Tags	Only in Add Members. Tags given to the subscriber when they are added.
Email Type	The email format they prefer: html or text. Default: html.
VIP Status	Check it to mark the subscriber as VIP in Mailchimp.
Include Groups	Turn it on to add the subscriber to an interest group of the list.
Group ID	The list’s interest group. The dropdown shows the groups of the chosen list.
Group Options	The option of the group the subscriber joins, for example News within the Topics group.

Output

The Data output returns one item per subscriber, with their email, status, name and the other details they have in Mailchimp, including the names of the groups they belong to. In Delete Members and Manage Member Tags it returns a confirmation with the email and, in the second case, the tags.

You can connect the result to another component, a spreadsheet or an agent. The component can also be connected to an Agent as a tool, so the agent decides when to look up or add subscribers. See Tool Mode.

Example

A bookstore wants everyone who joins its reading club on the website to land in its Mailchimp list.

1. The form reaches the flow with the person’s name and email.
2. Add Member with Add Members, pick the club’s list in List ID and put the email in Email.
3. Set Status to Pending so Mailchimp asks them to confirm their sign-up.
4. Open the advanced options, turn on Include Fields, pick First Name in Fields and fill it with the name from the form.

Good practices

• Always check Status when you add or update a subscriber: Update Members also sends it, so a subscriber who had unsubscribed would be subscribed again with the default.
• Use Pending when people sign up on your website: they confirm their sign-up and you meet consent requirements.
• Update Members identifies the subscriber by their email, so it cannot change the email itself.

Related components

• Campaign: manage the campaigns your subscribers receive.
• Mailchimp Webhook: get notified when someone subscribes or unsubscribes.