tag_member
Add or remove tags from a single Mailchimp member without altering profile data or subscription status. Tags are created automatically if new; missing tags are ignored.
Instructions
Add or remove tags from a single member. Does not modify profile data or subscription status.
Tags are case-insensitive free-form labels. Added tags are created automatically if new; removed tags are silently ignored if not present. Idempotent. Choose the right member tool: tag_member for per-member tag changes, add_members_to_segment for bulk-adding members to a tag/segment, add_member with tags param for tagging at signup, update_member for profile/status changes, get_member_tags to check current tags.
Authenticated via API key (read scope required). Max 10 concurrent requests. Respects read-only and dry-run modes. Returns 404 error if the member does not exist.
Args: list_id: Audience/list ID (10-char alphanumeric, e.g. 'abc123def4'). Obtain from list_audiences. email_address: Email of the member. Must exist in the audience. tags_to_add: Comma-separated tag names to add (e.g. 'VIP,Returning Customer'). tags_to_remove: Comma-separated tag names to remove (e.g. 'Trial').
Returns: JSON with status ("updated"), email_address, tags array with name and status 'active'/'inactive'.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| list_id | Yes | ||
| email_address | Yes | ||
| tags_to_add | No | ||
| tags_to_remove | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |