Action: Add Member

Mailchimp Operation

The List Members action enables users to add a new member to a specific list in Mailchimp.

Example User Story

As a marketing manager, I want to add a new subscriber to a Mailchimp list so that they receive our newsletter updates.

Fields

Field Name	Field Type	Required
list_id	String	Yes
email_address	String	Yes
status	String	No
merge_fields	Map	No

Related Connections

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "add-list-member",
  "state": "inDev",
  "meta": {
    "short": "Add List Member",
    "description": "Add a new member to a specific Mailchimp list."
  },
  "input": [
    {
      "name": "list_id",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The unique ID for the Mailchimp list."
      }
    },
    {
      "name": "email_address",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The email address of the member to add."
      }
    },
    {
      "name": "status",
      "type": "String",
      "required": false,
      "meta": {
        "description": "The status of the member (e.g., 'subscribed', 'unsubscribed').",
        "default": "subscribed"
      }
    },
    {
      "name": "merge_fields",
      "type": "Map",
      "required": false,
      "meta": {
        "description": "Additional merge fields for the member."
      }
    }
  ],
  "output": [
    {
      "name": "id",
      "type": "String",
      "selector": ["id"],
      "meta": {
        "description": "The unique ID for the member."
      }
    },
    {
      "name": "email_address",
      "type": "String",
      "selector": ["email_address"],
      "meta": {
        "description": "The email address of the member."
      }
    },
    {
      "name": "status",
      "type": "String",
      "selector": ["status"],
      "meta": {
        "description": "The status of the member."
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "POST",
        "path": "/lists/{{list_id}}/members",
        "headers": {
          "Content-Type": "application/json"
        },
        "bodyTemplate": {
          "value": "{\"email_address\": \"{{email_address}}\", \"status\": \"{{status}}\", \"merge_fields\": {{merge_fields}}}",
          "placeholders": [
            {
              "name": "email_address",
              "type": "String",
              "description": "The email address of the member to add.",
              "required": true
            },
            {
              "name": "status",
              "type": "String",
              "description": "The status of the member.",
              "required": false,
              "default": "subscribed"
            },
            {
              "name": "merge_fields",
              "type": "Map",
              "description": "Additional merge fields for the member.",
              "required": false
            }
          ]
        }
      }
    }
  ]
}