Mailchimp Audiences ListMembers

Mailchimp Audiences ListMembers

Certified

List members of a Mailchimp audience

Reads the members of an audience with GET /lists/{listId}/members, 1000 per request, until maxItems or the end. Use fetchType: STORE for large audiences: rows are streamed to an ION file instead of kept in memory.

Each row exposes id, emailAddress, status, mergeFields (nested keys such as FNAME are unchanged), tags, timestampOpt, lastChanged, language and vip; every other Mailchimp field keeps its original key.

yaml
type: io.kestra.plugin.mailchimp.audiences.ListMembers

Store all subscribed members of an audience, changed since a date, as an ION file.

yaml
id: mailchimp_list_members
namespace: company.team

tasks:
  - id: members
    type: io.kestra.plugin.mailchimp.audiences.ListMembers
    apiKey: "{{ secret('MAILCHIMP_API_KEY') }}"
    listId: "a1b2c3d4e5"
    status: SUBSCRIBED
    sinceLastChanged: "2026-01-01T00:00:00Z"
    fetchType: STORE
Properties

Audience ID

Mailchimp audience (list) id, found in the audience settings or with ListAudiences.

OAuth access token

Set exactly one of apiKey or accessToken. server is required with an access token.

Mailchimp API key

Set exactly one of apiKey or accessToken. The data center is taken from the key suffix (for example -us19) unless server is set.

Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

Asset failure behavior

Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150

Base URL override

Replaces https://<server>.api.mailchimp.com/3.0. The credential is sent to this URL, so it must be an https *.api.mailchimp.com host.

Possible Values
STOREFETCHFETCH_ONENONE

Fetch strategy

FETCH_ONE: first record only. FETCH: all records in memory. STORE: write rows as ION to internal storage and return the URI. NONE: only count them. Default FETCH, except STORE for ListMembers and ListEmailActivity, which can return very many rows.

SubTypestring

Fields

Restrict the response to these Mailchimp fields, using Mailchimp's dotted syntax, e.g. members.id, members.email_address, total_items.

Max items

Stop after this many records. Must be at least 1. Default: unlimited, so set it to bound a huge result.

Default3

Max retries

Retries done by this plugin on HTTP 429 (all methods) and on 5xx or I/O errors (GET and PUT only), with exponential backoff. Default 3, between 0 and 10. Kestra's HTTP client also replays a GET or PUT once after a 429 or 503 on its own, so 0 only turns off the plugin's retries.

Opted in since

Only members who opted in after this ISO-8601 date and time (since_timestamp_opt).

Data center

Mailchimp data center such as us19. Required with accessToken, optional with apiKey (overrides the key suffix).

Changed since

Only members changed after this ISO-8601 date and time (since_last_changed).

Possible Values
ASCDESC

Sort direction

ASC or DESC; Mailchimp only applies it together with sortField.

Possible Values
TIMESTAMP_OPTTIMESTAMP_SIGNUPLAST_CHANGED

Sort field

Field to sort by: TIMESTAMP_OPT, TIMESTAMP_SIGNUP or LAST_CHANGED. Sent lower case to Mailchimp.

Possible Values
SUBSCRIBEDUNSUBSCRIBEDCLEANEDPENDINGTRANSACTIONALARCHIVED

Status

Only members with this status: SUBSCRIBED, UNSUBSCRIBED, CLEANED, PENDING, TRANSACTIONAL or ARCHIVED. Sent lower case to Mailchimp.

DefaultPT2M

Request timeout

Idle read timeout of each call: how long to wait without receiving data. Default PT2M, must be positive. Mailchimp itself cuts requests off after 120 seconds.

First record

Populated when fetchType is FETCH_ONE.

SubTypeobject

Records

Populated when fetchType is FETCH.

Record count

Number of records read from Mailchimp.

Total count

Total number of matching records reported by Mailchimp (total_items), when available.

Formaturi

Stored records URI

Populated when fetchType is STORE: an ION file in internal storage.

More Plugins in this Category

Salesforce (EE)
Salesforce
Enterprise

Tasks that connect to Salesforce in Kestra to query data, manage records, and trigger flows from CRM events.

Business

5 tasks

1 blueprints

YouTube
YouTube

Tasks that interact with the YouTube Data API.

Business

4 tasks

7 blueprints