View as Markdown
Mailchimp icon

Mailchimp ACTION

Add Subscriber To Tag

Adds an email address to a tag within an audience. See docs here
  • Action
  • Writes data
  • Destructive
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Mailchimp account once, then configure and run Add Subscriber To Tag 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-add-subscriber-to-tag",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    mailchimp: { authProvisionId: "apn_xxxxxxx" },
    listId: "List Id",
    subscriberHash: "Subscriber",
  },
})

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.

Add Subscriber To Tag inputs
Property Type Description
listId List Id string
The unique ID of the list
Required Dynamic
subscriberHash Subscriber string
The MD5 hash of the lowercase version of the list member's email address.
Required Dynamic
tags Tags string[]
Stringified object list of fields to return. name, or status (Possible status values: "inactive" or "active") properties allowed. Example: { "name":"college", "status":"active", }
Required

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-add-subscriber-to-tag
Version
0.2.4
App
Mailchimp
Authentication
OAuth
Read-only
No
Destructive
Yes
Open world
Yes