View as Markdown
Mailchimp icon

Mailchimp ACTION

Search Lists

Searches for lists. See docs here
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Mailchimp account once, then configure and run Search Lists from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "mailchimp-search-lists",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    mailchimp: { authProvisionId: "apn_xxxxxxx" },
    beforeDateCreated: "Before date created",
    sinceDateCreated: "Since date created",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Search Lists inputs
Property Type Description
beforeDateCreated Before date created string
Restrict response to lists created before the set date. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
Optional
sinceDateCreated Since date created string
Restrict results to lists created after the set date. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
Optional
beforeCampaignLastSent Before campaign last sent string
Restrict results to lists created before the last campaign send date. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
Optional
sinceCampaignLastSent Since campaign last sent string
Restrict results to lists created after the last campaign send date. Uses ISO 8601 time format: 2015-10-21T15:41:36+00:00.
Optional
email Email string
Restrict results to lists that include a specific subscriber's email address.
Optional
sortField Sort field string
Returns files sorted by the specified field. Possible value: "date_created"
Optional
sortDir Sort direction string
Determines the order direction for sorted results. Possible values: ASC or DESC.
Optional
hasEcommerceStore Has ecommerce store? boolean
The unique ID for the list
Optional
includeTotalContacts Include total contacts boolean
Return the total_contacts field in the stats response, which contains an approximate count of all contacts in any state.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
mailchimp-search-lists
Version
0.0.2
App
Mailchimp
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes