Action: Add/Update (upsert) Member

Mailchimp Operation

The List Members action enables users to update an existing member in a specific list in Mailchimp.

Example User Story

As a marketing manager, I want to update a subscriber's details in a Mailchimp list so that I can keep the contact information current and relevant for email campaigns.

Fields

Field Name	Field Type	Required
list_id	String	Yes
subscriber_hash	String	Yes
email_address	String	No
status	String	No
merge_fields	Object	No
interests	Object	No
language	String	No
vip	Boolean	No
location	Object	No
marketing_permissions	Array	No
ip_signup	String	No
timestamp_signup	String	No

Related Connections

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "update-list-member",
  "state": "inDev",
  "meta": {
    "short": "Update List Member",
    "description": "Update an existing member in a Mailchimp list."
  },
  "input": [
    {
      "name": "list_id",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The unique ID for the Mailchimp list."
      }
    },
    {
      "name": "subscriber_hash",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The MD5 hash of the lowercase version of the list member's email address."
      }
    },
    {
      "name": "email_address",
      "type": "String",
      "required": false,
      "meta": {
        "description": "Email address for the subscriber."
      }
    },
    {
      "name": "status",
      "type": "String",
      "required": false,
      "meta": {
        "description": "Subscriber's status (e.g., 'subscribed', 'unsubscribed', 'cleaned', 'pending').",
        "options": ["subscribed", "unsubscribed", "cleaned", "pending"]
      }
    },
    {
      "name": "merge_fields",
      "type": "Object",
      "required": false,
      "meta": {
        "description": "Merge fields for the subscriber."
      }
    },
    {
      "name": "interests",
      "type": "Object",
      "required": false,
      "meta": {
        "description": "Interests for the subscriber."
      }
    },
    {
      "name": "language",
      "type": "String",
      "required": false,
      "meta": {
        "description": "Subscriber's language preference."
      }
    },
    {
      "name": "vip",
      "type": "Boolean",
      "required": false,
      "meta": {
        "description": "VIP status for the subscriber."
      }
    },
    {
      "name": "location",
      "type": "Object",
      "required": false,
      "meta": {
        "description": "Location information for the subscriber."
      }
    },
    {
      "name": "marketing_permissions",
      "type": "Array",
      "required": false,
      "meta": {
        "description": "Marketing permissions for the subscriber."
      }
    },
    {
      "name": "ip_signup",
      "type": "String",
      "required": false,
      "meta": {
        "description": "IP address the subscriber signed up from."
      }
    },
    {
      "name": "timestamp_signup",
      "type": "String",
      "required": false,
      "meta": {
        "description": "Sign-up timestamp for the subscriber."
      }
    }
  ],
  "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 for the member."
      }
    },
    {
      "name": "status",
      "type": "String",
      "selector": ["status"],
      "meta": {
        "description": "The status of the member."
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "PUT",
        "path": "/lists/{{list_id}}/members/{{subscriber_hash}}",
        "headers": {
          "Content-Type": "application/json"
        },
        "bodyTemplate": {
          "value": "{\"email_address\":\"{{email_address}}\",\"status\":\"{{status}}\",\"merge_fields\":{{merge_fields}},\"interests\":{{interests}},\"language\":\"{{language}}\",\"vip\":{{vip}},\"location\":{{location}},\"marketing_permissions\":{{marketing_permissions}},\"ip_signup\":\"{{ip_signup}}\",\"timestamp_signup\":\"{{timestamp_signup}}\"}",
          "placeholders": [
            {
              "name": "email_address",
              "type": "String",
              "description": "Email address for the subscriber.",
              "required": false
            },
            {
              "name": "status",
              "type": "String",
              "description": "Subscriber's status.",
              "required": false
            },
            {
              "name": "merge_fields",
              "type": "Object",
              "description": "Merge fields for the subscriber.",
              "required": false
            },
            {
              "name": "interests",
              "type": "Object",
              "description": "Interests for the subscriber.",
              "required": false
            },
            {
              "name": "language",
              "type": "String",
              "description": "Subscriber's language preference.",
              "required": false
            },
            {
              "name": "vip",
              "type": "Boolean",
              "description": "VIP status for the subscriber.",
              "required": false
            },
            {
              "name": "location",
              "type": "Object",
              "description": "Location information for the subscriber.",
              "required": false
            },
            {
              "name": "marketing_permissions",
              "type": "Array",
              "description": "Marketing permissions for the subscriber.",
              "required": false
            },
            {
              "name": "ip_signup",
              "type": "String",
              "description": "IP address the subscriber signed up from.",
              "required": false
            },
            {
              "name": "timestamp_signup",
              "type": "String",
              "description": "Sign-up timestamp for the subscriber.",
              "required": false
            }
          ]
        }
      }
    }
  ]
}