Mailchimp

Marketing integration · 17 node(s) including 1 trigger.

00Overview

Every field below is exactly what you see in the Flomation editor. Fields marked ● live picker let you choose from a list pulled live from your account — no IDs to look up.

01Connecting Mailchimp

Add your credentials as a Flomation environment secret, then pick them in each node. The connection fields are:

Field	Type		Details
Mailchimp API Key	`secret`	Required	xxxxxxxx-us6

Pick an Environment on your flow (Flow Settings → Environment) so the secret resolves. Secret fields never show the value — they reference ${secrets.your_secret}.

02Audience

Audience: List

mailchimp/audience_list · Action

List the Mailchimp audiences (lists) in the account. Use this to discover audience (list) IDs for the other actions.

Field	Type		Details
Mailchimp API Key	`secret`	Required	xxxxxxxx-us6
Return All	`boolean`
Limit	`integer`		500 (max 1000)
Offset	`integer`

Returns: results, count, total_items, result, tool_result, success, error

03Campaign

Campaign: Delete

mailchimp/campaign_delete · Action

Permanently delete a Mailchimp campaign by its ID. This cannot be undone.

Field	Type		Details
Mailchimp API Key	`secret`	Required	xxxxxxxx-us6
Campaign ID	`string`	Required

Returns: tool_result, success, error

Campaign: Get

mailchimp/campaign_get · Action

Retrieve a single Mailchimp campaign by its ID, including its settings, recipients, and delivery status.

Field	Type		Details
Mailchimp API Key	`secret`	Required	xxxxxxxx-us6
Campaign ID	`string`	Required

Returns: id, result, tool_result, success, error

Campaign: List

mailchimp/campaign_list · Action

List Mailchimp campaigns, optionally filtered by audience, status, and send/create time. Sort and paginate the results.

Field	Type		Details
Mailchimp API Key	`secret`	Required	xxxxxxxx-us6
Filter by Audience (List) ID	`string`
Status	`string`		choices: Save, Sending, Schedule, Sent
Sort Field	`string`		choices: Create Time, Send Time
Sort Direction	`string`		choices: Ascending, Descending
Before Send Time	`string`		ISO 8601, e.g. 2026-07-01T00:00:00+00:00
Since Send Time	`string`		ISO 8601, e.g. 2026-07-01T00:00:00+00:00
Before Create Time	`string`		ISO 8601, e.g. 2026-07-01T00:00:00+00:00
Since Create Time	`string`		ISO 8601, e.g. 2026-07-01T00:00:00+00:00
Fields	`string`		Comma-separated fields to include, e.g. campaigns.id,campaigns.settings.title
Exclude Fields	`string`		Comma-separated fields to omit
Return All	`boolean`
Limit	`integer`		10 (max 1000)
Offset	`integer`

Returns: results, count, total_items, result, tool_result, success, error

Campaign: Replicate

mailchimp/campaign_replicate · Action

Create a copy of an existing Mailchimp campaign. Returns the newly created campaign.

Field	Type		Details
Mailchimp API Key	`secret`	Required	xxxxxxxx-us6
Campaign ID	`string`	Required

Returns: id, result, tool_result, success, error

Campaign: Resend

mailchimp/campaign_resend · Action

Create a resend-to-non-openers version of a sent Mailchimp campaign. Returns the newly created campaign.

Field	Type		Details
Mailchimp API Key	`secret`	Required	xxxxxxxx-us6
Campaign ID	`string`	Required

Returns: id, result, tool_result, success, error

Campaign: Send

mailchimp/campaign_send · Action

Send a Mailchimp campaign immediately to its configured recipients.

Field	Type		Details
Mailchimp API Key	`secret`	Required	xxxxxxxx-us6
Campaign ID	`string`	Required

Returns: tool_result, success, error

04Interest

Interest Category: List

mailchimp/interest_category_list · Action

List the interest categories (groupings) of a Mailchimp audience. Use this to discover interest category IDs.

Field	Type		Details
Mailchimp API Key	`secret`	Required	xxxxxxxx-us6
Audience (List) ID	`string`	Required	Use Audience: List to find it
Return All	`boolean`
Limit	`integer`		500 (max 1000)
Offset	`integer`

Returns: results, count, total_items, result, tool_result, success, error

05List

Interest Group: List

mailchimp/list_group_list · Action

List the interests (groups) within an interest category of a Mailchimp audience. Use this to discover interest IDs.

Field	Type		Details
Mailchimp API Key	`secret`	Required	xxxxxxxx-us6
Audience (List) ID	`string`	Required	Use Audience: List to find it
Interest Category ID (from Interest Category: List)	`string`	Required
Return All	`boolean`
Limit	`integer`		500 (max 1000)
Offset	`integer`

Returns: results, count, total_items, result, tool_result, success, error

06Member

Member: Create

mailchimp/member_create · Action

Add a member (subscriber) to a Mailchimp audience. Set status, merge fields (FNAME/LNAME/…), tags, interests, and location. Returns the created member.

Field	Type		Details
Mailchimp API Key	`secret`	Required	xxxxxxxx-us6
Audience (List) ID	`string`	Required	Use Audience: List to find it
Email	`string`	Required	name@example.com
Status	`string`	Required	choices: Subscribed, Unsubscribed, Pending (double opt-in), Cleaned, Transactional
Email Type	`string`		choices: HTML, Text
Language	`string`		en
VIP	`boolean`
Signup IP	`string`		Opt-in source IP (optional)
Opt-in IP	`string`		Confirmation IP (optional)
Signup Timestamp	`string`		ISO 8601, e.g. 2026-07-01T00:00:00+00:00
Opt-in Timestamp	`string`		ISO 8601, e.g. 2026-07-01T00:00:00+00:00
Tags	`string`		Comma-separated tag names
Merge Fields	`key_value_array`		Merge tag = value, e.g. FNAME = Ada
Merge Fields (JSON, advanced)	`object`		{"FNAME":"Ada","ADDRESS":{...}}
Interests (JSON)	`object`		{"<interestId>":true}
Location (JSON)	`object`		{"latitude":51.5,"longitude":-0.1}

Returns: id, status, member, tool_result, success, error

Member: Delete

mailchimp/member_delete · Action

Remove a member (subscriber) from a Mailchimp audience. By default archives the member (reversible); optionally permanently delete them (irreversible).

Field	Type		Details
Mailchimp API Key	`secret`	Required	xxxxxxxx-us6
Audience (List) ID	`string`	Required	Use Audience: List to find it
Email	`string`	Required	name@example.com
Permanent (irreversible)	`boolean`		Off = archive (reversible); On = permanently delete

Returns: tool_result, success, error

Member: Get

mailchimp/member_get · Action

Retrieve a single member (subscriber) from a Mailchimp audience by email. Optionally include or exclude specific fields. Returns the member.

Field	Type		Details
Mailchimp API Key	`secret`	Required	xxxxxxxx-us6
Audience (List) ID	`string`	Required	Use Audience: List to find it
Email	`string`	Required	name@example.com
Fields	`string`		Comma-separated fields to include
Exclude Fields	`string`		Comma-separated fields to exclude

Returns: id, status, member, tool_result, success, error

Member: List

mailchimp/member_list · Action

List members (subscribers) in a Mailchimp audience. Filter by status, email type, and change/creation timestamps. Returns all matching members or a single page.

Field	Type		Details
Mailchimp API Key	`secret`	Required	xxxxxxxx-us6
Audience (List) ID	`string`	Required	Use Audience: List to find it
Status	`string`		choices: Subscribed, Unsubscribed, Cleaned, Pending, Transactional
Email Type	`string`		choices: HTML, Text
Since Last Changed	`string`		ISO timestamp
Before Last Changed	`string`		ISO timestamp
Since Opt-in Timestamp	`string`		ISO timestamp
Before Opt-in Timestamp	`string`		ISO timestamp
Return All	`boolean`
Limit	`integer`		Max results (default 500, max 1000)
Offset	`integer`

Returns: results, count, total_items, result, tool_result, success, error

Member Tag: Add

mailchimp/member_tag_add · Action

Add one or more tags to a Mailchimp audience member. Tags are matched or created by name and applied as active.

Field	Type		Details
Mailchimp API Key	`secret`	Required	xxxxxxxx-us6
Audience (List) ID	`string`	Required	Use Audience: List to find it
Email	`string`	Required	name@example.com
Tags	`string`	Required	Comma-separated tag names
Suppress tag-triggered automations	`boolean`

Returns: tool_result, success, error

Member Tag: Remove

mailchimp/member_tag_remove · Action

Remove one or more tags from a Mailchimp audience member. Tags are matched by name and marked inactive.

Field	Type		Details
Mailchimp API Key	`secret`	Required	xxxxxxxx-us6
Audience (List) ID	`string`	Required	Use Audience: List to find it
Email	`string`	Required	name@example.com
Tags	`string`	Required	Comma-separated tag names
Suppress tag-triggered automations	`boolean`

Returns: tool_result, success, error

Member: Update

mailchimp/member_update · Action

Update a member (subscriber) in a Mailchimp audience, creating it if it does not exist (upsert). Set status, merge fields, interests, location, and more. Returns the member.

Field	Type		Details
Mailchimp API Key	`secret`	Required	xxxxxxxx-us6
Audience (List) ID	`string`	Required	Use Audience: List to find it
Email	`string`	Required	name@example.com
Status	`string`		Required only when creating a new member — choices: Subscribed, Unsubscribed, Pending (double opt-in), Cleaned, Transactional
Email Type	`string`		choices: HTML, Text
Language	`string`		en
VIP	`boolean`
Signup IP	`string`		Opt-in source IP (optional)
Opt-in IP	`string`		Confirmation IP (optional)
Signup Timestamp	`string`		ISO 8601, e.g. 2026-07-01T00:00:00+00:00
Opt-in Timestamp	`string`		ISO 8601, e.g. 2026-07-01T00:00:00+00:00
Merge Fields	`key_value_array`		Merge tag = value, e.g. FNAME = Ada
Merge Fields (JSON, advanced)	`object`		{"FNAME":"Ada","ADDRESS":{...}}
Interests (JSON)	`object`		{"<interestId>":true}
Location (JSON)	`object`		{"latitude":51.5,"longitude":-0.1}
Skip Merge Validation	`boolean`

Returns: id, status, member, tool_result, success, error

07Triggers

Mailchimp Trigger

trigger/mailchimp_webhook · Trigger

Triggers a flow on Mailchimp audience events (subscribe, unsubscribe, profile update, cleaned, email changed, campaign sent) via a webhook.

Field	Type		Details
Mailchimp API Key	`secret`	Required	xxxxxxxx-us6
Audience (List) ID	`string`	Required
Events	`string`		Comma-separated: subscribe,unsubscribe,profile,cleaned,upemail,campaign
Sources	`string`		Comma-separated: user,admin,api

Returns: content, event_type, list_id, email, fired_at, body, triggered_at

08Notes & Limitations

Behaviours and constraints worth knowing before you build with these nodes.

Adding a subscriber whose status is set to subscribed will be rejected by Mailchimp if that email previously unsubscribed or was cleaned — under Mailchimp's compliance rules they must re-opt-in through a signup form rather than the API.
Updating a member upserts: if no member matches the email it is created, so an intended edit of a non-existent contact silently adds a new subscriber instead of failing.
Members are looked up by a lowercased form of the email address, so use consistent casing and beware that the same address in different cases resolves to one contact.
Deleting a member archives them by default (reversible), but choosing permanent deletion is irreversible and that email address can never be re-added to the audience afterwards.
Tags on the add and remove actions are matched or created by name, so a typo in a tag name silently creates a brand-new tag rather than matching an existing one.
Sending, resending, or permanently deleting a campaign takes effect immediately and cannot be undone, so verify the campaign ID and recipients before running these actions.