MailchimpAdd contact
BetaChanges data
Adds a new contact to an audience and fails when the address is already there.
Settings
| Setting | What it is |
|---|---|
| ConnectionRequired | The Mailchimp connection the step signs in with. |
| Audience id | Picked from the list Mailchimp offers. |
| E-mail address | text |
| Status | Use Add or update contact unless you specifically want the flow to fail when the address is already there. |
| Tags | Comma separated. This is the one thing Add or update contact cannot do: tags at creation. |
| E-mail format | "" or "html" or "text" |
| Merge fields | Keyed by the merge TAG — FNAME, not First name. |
| Interest groups | Keyed by the interest id — the List interests node gives you the ids. |
| Language | text |
| VIP | "" or "on" or "off" |
| Latitude | text |
| Longitude | text |
| Marketing permissions | One object per permission; the audience defines the ids. |
| Sign-up IP address | text |
| Sign-up moment | text |
| Opt-in IP address | text |
| Opt-in moment | text |
| Accept a missing merge field | Accepts the contact even when a required merge field is missing. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `mailchimp`) |
audienceId | texta value from the vendor's own list |
email | text |
status | "subscribed" or "unsubscribed" or "pending" or "transactional" or "cleaned", by default "subscribed" |
tags | text |
emailType | "" or "html" or "text" |
mergeFields | object of text, by default {} |
interests | object of true/false, by default {} |
language | text |
vip | "" or "on" or "off" |
latitude | text |
longitude | text |
marketingPermissions | list of any JSON, by default [] |
ipSignup | text |
timestampSignup | text |
ipOpt | text |
timestampOpt | text |
skipMergeValidation | true/false, by default false |
Output
| Field | Type |
|---|---|
memberContact | object |
memberIdContact id | string |
emailE-mail address | string |
status | string |
tags | array |
mergeFields | object |
Sample output, and the expression for each field
- email"person@example.com"
- member
- email_address"person@example.com"
- id"7de8517bce4457e8390aa4006a1880fb"
- memberId"7de8517bce4457e8390aa4006a1880fb"
- mergeFields{}
- status"subscribed"
- tags[]
Errors
When a step of this node stops a run, the run page shows a code. Look it up:
Example step
The step as a flow file holds it. Replace each value in <…>.
{
"config": {
"audienceId": "",
"connection": "<connection id>",
"email": "",
"emailType": "",
"interests": {},
"ipOpt": "",
"ipSignup": "",
"language": "",
"latitude": "",
"longitude": "",
"marketingPermissions": [],
"mergeFields": {},
"skipMergeValidation": false,
"status": "subscribed",
"tags": "",
"timestampOpt": "",
"timestampSignup": "",
"vip": ""
},
"label": "Add contact",
"type": "mailchimp.addMember",
"version": 1
}