Skip to main content

Overview

The Mailchimp Agent Node provides an intelligent agent for managing your Mailchimp account. This node enables you to:
  • Manage lists/audiences and their members
  • Add, update, and remove subscribers
  • Create and manage segments for targeted campaigns
  • Apply tags to subscribers for organization
  • Create, configure, and send email campaigns
  • Manage campaign content and settings

Configuration Parameters

To set up the Mailchimp Agent Node, you need to authenticate with your Mailchimp account. Once authenticated, configure the agent to perform operations based on your workflow requirements.

Node Configuration

  • Prompt: Define the task for the agent to perform with Mailchimp.
    Add these email addresses to my “Newsletter” list with the tag “new-subscriber”
    Create a campaign for my newsletter list with subject “Weekly Update” and send it
    Get all subscribers from the “Customers” list who have the tag “premium”
  • Tools Select which tools the Mailchimp Agent can use:
    Tool nameDescription
    Get ListsRetrieve all lists/audiences
    Get ListGet details about a specific list
    Get List MembersFetch members from a list
    Add List MemberAdd new subscribers
    Update List MemberModify existing subscribers
    Add Or Update List MemberUpsert operation for subscribers
    Remove List MemberDelete subscribers
    Get List SegmentsView list segments
    Create List SegmentCreate new segments
    Add Members To SegmentAssign members to segments
    Get List TagsView available tags
    Add Tags To MemberApply tags to subscribers
    Remove Tags From MemberRemove tags from subscribers
    Get CampaignsList all campaigns
    Get CampaignGet campaign details
    Create CampaignCreate new campaigns
    Update Campaign SettingsModify campaign settings
    Set Campaign ContentSet campaign HTML/text content
    Send CampaignSend campaigns immediately
    Delete CampaignRemove campaigns
    Be careful with Send Campaign and Remove List Member - enable only when needed
  • System Prompt: Customize the agent’s behavior and guidelines.
  • Model: Select the language model for the agent (must support function calling).
  • Max Steps: Set the maximum number of steps the agent can take (1-20).
  • Enable Model Fallbacks: Allow automatic fallback to alternative models if the primary model fails.

Expected Inputs and Outputs

  • Inputs:
    • The node accepts text input that can be referenced in the prompt using format strings.
  • Outputs:
    • output: The final result from the agent’s actions
    • conversation: Detailed log of the agent’s reasoning and operations

Use Case Examples

  1. Automated Subscriber Management: Automatically add new customers to specific Mailchimp lists based on workflow triggers, with appropriate tags and segments.
  2. Campaign Automation: Create and send targeted email campaigns based on subscriber activity, applying different content for different segments.
  3. List Maintenance: Regularly clean up lists by removing inactive subscribers or updating subscriber information based on external data sources.

Error Handling and Troubleshooting

  • Authentication Issues: If the node fails to authenticate, ensure you’ve connected your Mailchimp account and the datacenter is correctly configured.
  • List Operations: Always verify the list ID exists before performing operations. Use Get Lists to find the correct list ID.
  • Campaign Sending: Before sending campaigns, ensure content is set and the campaign passes Mailchimp’s validation checks.
If you encounter any issues not covered in this documentation, please reach out to our support team for assistance.

Relevant Nodes