Mailchimp · Schema

Mailchimp List Member

A member (subscriber/contact) of a Mailchimp audience/list. Represents an individual who is currently or has been previously subscribed to a list, including members who have bounced or unsubscribed.

CampaignsEmail MarketingMarketing AutomationNewslettersTransactional Email

Properties

Name Type Description
id string The MD5 hash of the lowercase version of the list member's email address. This serves as the unique identifier for a member within a list.
email_address string Email address for the subscriber.
unique_email_id string An identifier for the address across all of Mailchimp.
contact_id string A contact identifier that is agnostic of email address. As Mailchimp evolves beyond email, contacts may exist without an email address.
full_name string The contact's full name.
web_id integer The ID used in the Mailchimp web application.
email_type string Type of email this member asked to get ('html' or 'text').
status string Subscriber's current status.
unsubscribe_reason string A subscriber's reason for unsubscribing.
consents_to_one_to_one_messaging boolean Indicates whether a contact consents to 1:1 messaging.
sms_phone_number string A US phone number for SMS contact.
sms_subscription_status string The status of an SMS subscription.
sms_subscription_last_updated string The datetime when the SMS subscription was last updated.
merge_fields object A dictionary of merge fields where the keys are the merge tags (e.g., FNAME, LNAME). Values are the corresponding merge field values.
interests object The key of this object's properties is the ID of the interest in question, and the value is a boolean indicating whether the member is in that interest group.
stats object Open and click rates for this subscriber.
ip_signup string IP address the subscriber signed up from.
timestamp_signup string The date and time the subscriber signed up for the list in ISO 8601 format.
ip_opt string The IP address the subscriber used to confirm their opt-in status.
timestamp_opt string The date and time the subscriber confirmed their opt-in status in ISO 8601 format.
member_rating integer Star rating for this member, between 1 and 5.
last_changed string The date and time the member's info was last changed in ISO 8601 format.
language string If set/detected, the subscriber's language.
vip boolean VIP status for subscriber.
email_client string The list member's email client.
location object Subscriber location information.
marketing_permissions array The marketing permissions for the subscriber.
last_note object The most recent note added about this member.
source string The source from which the subscriber was added to this list.
tags_count integer The number of tags applied to this member.
tags array Tags applied to the member for additional segmentation and organization.
list_id string The list ID that this member belongs to.
View JSON Schema on GitHub