FlowmageDocs

Update contact

BetaChanges data

Changes the details of a contact who is already in an audience.

Settings

SettingWhat it is
ConnectionRequiredThe Mailchimp connection the step signs in with.
Audience idPicked from the list Mailchimp offers.
E-mail addressThe contact to change. Mailchimp finds them by this address.
StatusTransactional is not offered here: Mailchimp accepts it only when the contact is created.
E-mail format"" or "html" or "text"
Merge fieldsKeyed by the merge TAG. A tag you leave out is left alone.
Interest groupsKeyed by the interest id. An interest you leave out is left alone.
Languagetext
VIP"" or "on" or "off"
Latitudetext
Longitudetext
Marketing permissionsOne object per permission; the audience defines the ids.
Sign-up IP addresstext
Sign-up momenttext
Opt-in IP addresstext
Opt-in momenttext
Accept a missing merge fieldAccepts the change even when a required merge field is missing.
Technical details
KeyValue
connectiontexta connection id from `requires.connections` (provider `mailchimp`)
audienceIdtexta value from the vendor's own list
emailtext
status"" or "subscribed" or "unsubscribed" or "pending" or "cleaned"
emailType"" or "html" or "text"
mergeFieldsobject of text, by default {}
interestsobject of true/false, by default {}
languagetext
vip"" or "on" or "off"
latitudetext
longitudetext
marketingPermissionslist of any JSON, by default []
ipSignuptext
timestampSignuptext
ipOpttext
timestampOpttext
skipMergeValidationtrue/false, by default false

Output

FieldType
memberContactobject
memberIdContact idstring
emailE-mail addressstring
statusstring
tagsarray
mergeFieldsobject
Sample output, and the expression for each field
  • email"person@example.com"
  • member
    • email_address"person@example.com"
    • id"7de8517bce4457e8390aa4006a1880fb"
  • memberId"7de8517bce4457e8390aa4006a1880fb"
  • mergeFields{}
  • status"unsubscribed"
  • 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": "",
    "timestampOpt": "",
    "timestampSignup": "",
    "vip": ""
  },
  "label": "Update contact",
  "type": "mailchimp.updateMember",
  "version": 1
}