Skip to content

Mailchimp

Mailchimp is a marketing automation and email marketing platform.

Categories: marketing-automation

Type: mailchimp/v1


Connections

Version: 1

OAuth2 Authorization Code

Properties

NameLabelTypeControl TypeDescriptionRequired
clientIdClient IdSTRINGTEXTtrue
clientSecretClient SecretSTRINGTEXTtrue

Actions

Add Member to List

Name: addMemberToList

Adds a new member to the list.

Properties

NameLabelTypeControl TypeDescriptionRequired
listIdList IDSTRINGSELECTThe unique ID for the list.true
skip_merge_validationSkip Merge ValidationBOOLEAN
Options true, false
SELECTIf skip_merge_validation is true, member data will be accepted without merge field values, even if the merge field is usually required. This defaults to false.false
__itemItemOBJECT
Properties {STRING(email_address), STRING(status), STRING(email_type), {}(merge_fields), {}(interests), STRING(language), BOOLEAN(vip), {NUMBER(latitude), NUMBER(longitude)}(location), [{STRING(marketing_permission_id), BOOLEAN(enabled)}](marketing_permissions), STRING(ip_signup), STRING(timestamp_signup), STRING(ip_opt), STRING(timestamp_opt), [STRING](tags)}
OBJECT_BUILDERnull

Output

Sample Output:

{timestamp_opt=2019-08-24T14:15:22, unsubscribe_reason=string, status=subscribed, email_address=string, last_note={note=string, created_at=2019-08-24T14:15:22, note_id=0, created_by=string}, contact_id=string, stats={ecommerce_data={currency_code=USD, number_of_orders=0, total_revenue=0}, avg_open_rate=0, avg_click_rate=0}, merge_fields={property2=, property1=}, full_name=string, list_id=string, tags_count=0, unique_email_id=string, email_client=string, consents_to_one_to_one_messaging=true, source=string, last_changed=2019-08-24T14:15:22, vip=true, member_rating=0, web_id=0, _links=[{rel=string, href=string, schema=string, targetSchema=string, method=GET}], id=string, timestamp_signup=2019-08-24T14:15:22, interests={property2=true, property1=true}, language=string, email_type=string, marketing_permissions=[{enabled=true, marketing_permission_id=string, text=string}], tags=[{name=string, id=0}], ip_signup=string, location={longitude=0, gmtoff=0, country_code=string, timezone=string, dstoff=0, latitude=0, region=string}, ip_opt=string}

Type: OBJECT

Properties

NameTypeControl Type
idSTRINGTEXT
email_addressSTRINGTEXT
unique_email_idSTRINGTEXT
contact_idSTRINGTEXT
full_nameSTRINGTEXT
web_idSTRINGTEXT
email_typeSTRINGTEXT
statusSTRING
Options subscribed, unsubscribed, cleaned, pending, transactional
SELECT
unsubscribe_reasonSTRINGTEXT
consents_to_one_to_one_messagingBOOLEAN
Options true, false
SELECT
merge_fieldsOBJECT
Properties {}
OBJECT_BUILDER
interestsOBJECT
Properties {}
OBJECT_BUILDER
statsOBJECT
Properties {NUMBER(avg_open_rate), NUMBER(avg_click_rate), {NUMBER(total_revenue), NUMBER(number_of_orders), STRING(currency_code)}(ecommerce_data)}
OBJECT_BUILDER
ip_signupSTRINGTEXT
timestamp_signupSTRINGTEXT
ip_optSTRINGTEXT
timestamp_optSTRINGTEXT
member_ratingINTEGERINTEGER
last_changedSTRINGTEXT
languageSTRINGTEXT
vipBOOLEAN
Options true, false
SELECT
email_clientSTRINGTEXT
locationOBJECT
Properties {NUMBER(latitude), NUMBER(longitude), INTEGER(gmtoff), INTEGER(dstoff), STRING(country_code), STRING(timezone), STRING(region)}
OBJECT_BUILDER
marketing_permissionsARRAY
Items [{STRING(marketing_permission_id), STRING(text), BOOLEAN(enabled)}]
ARRAY_BUILDER
last_noteOBJECT
Properties {INTEGER(note_id), STRING(created_at), STRING(created_by), STRING(note)}
OBJECT_BUILDER
sourceSTRINGTEXT
tags_countINTEGERINTEGER
tagsOBJECT
Properties {INTEGER(id), STRING(name)}
OBJECT_BUILDER
list_idSTRINGTEXT
_linksARRAY
Items [{STRING(rel), STRING(href), STRING(method), STRING(targetSchema), STRING(schema)}]
ARRAY_BUILDER

JSON Example

{
"label" : "Add Member to List",
"name" : "addMemberToList",
"parameters" : {
"listId" : "",
"skip_merge_validation" : false,
"__item" : {
"email_address" : "",
"status" : "",
"email_type" : "",
"merge_fields" : { },
"interests" : { },
"language" : "",
"vip" : false,
"location" : {
"latitude" : 0.0,
"longitude" : 0.0
},
"marketing_permissions" : [ {
"marketing_permission_id" : "",
"enabled" : false
} ],
"ip_signup" : "",
"timestamp_signup" : "",
"ip_opt" : "",
"timestamp_opt" : "",
"tags" : [ "" ]
}
},
"type" : "mailchimp/v1/addMemberToList"
}

Triggers

Subscribe

Name: subscribe

Triggers when an Audience subscriber is added to the list.

Type: DYNAMIC_WEBHOOK

Properties

NameLabelTypeControl TypeDescriptionRequired
listIdList IdSTRINGSELECTThe list id of intended audience to which you would like to add the contact.true

Output

Type: OBJECT

Properties

NameTypeControl Type
dataOBJECT
Properties {STRING(email), STRING(email_type), STRING(id), STRING(ip_opt), STRING(ip_signup), STRING(list_id), {STRING(EMAIL), STRING(FNAME), STRING(INTERESTS), STRING(LNAME)}(merges)}
OBJECT_BUILDER
fired_atDATE_TIMEDATE_TIME
typeSTRINGTEXT

JSON Example

{
"label" : "Subscribe",
"name" : "subscribe",
"parameters" : {
"listId" : ""
},
"type" : "mailchimp/v1/subscribe"
}