Version: Next

Mailchimp

Anedot's integration with Mailchimp sends leads and donations to the platform for Action Pages.

Setup

You can connect Anedot to Mailchimp by going to Settings > Integrations .
Select which Action Pages you would like to sync with MailChimp (default: all Action Pages).
Optionally, you can enter a comma separated list of Action Page IDs that you would like excluded from MailChimp.
Optionally, you can also scope the integration to only send team-specific data to MailChimp (if no team is selected it will sync all Action Pages specified in the fields above).
Enter your MailChimp API Key .
Enter your MailChimp List ID (also known as Audience ID).
Once you save the credentials, you are all set!

The Action Pages, Team, and credentials can be modified at any time post-setup.

If you need more help finding your Audience ID or your API Key, please get in touch with Mailchimp's Technical Support.

Data Relays

We send relays for financial and non-financial pages.
Push Unsent (all donations) + date range for relays works for financial and non-financial Pages.
MailChimp merges/de-duplicates based on email so if details change for that user, the field is overwritten by the newest relay. For example, if a donor makes another donation and uses a different name but the same email, the DONATEDATE & AMOUNT & FNAME will match the most recent relay, overwriting whatever used to be in those fields.
The relay will create a new contact record in MailChimp. There does not seem to be any notification or email from MailChimp’s side when this occurs.
When creating your “Audience fields and |MERGE| tags” (Audience > View Contacts > Settings > Audience fields and |MERGE| tags), you will need to match with the available Field Tags exactly.
“FNAME” - Anedot’s First Name field
“LNAME” - Anedot’s Last Name field
“PHONE” - Anedot’s Phone field
“STREET” - Anedot’s Address - Street Line 1 field
“STREET2” - Anedot’s Address - Street Line 2 field
“CITY” - Anedot’s Address - City field
“STATE” - Anedot’s Address - State field
“ZIPCODE” - Anedot’s Address - Zip Code field
“UTMCAMPGN” - Anedot’s UTM Campaign field
“UTMCONTENT” - Anedot’s UTM Content field
“UTMMEDIUM” - Anedot’s UTM Medium field
“UTMSOURCE” - Anedot’s UTM Source field
“UTMTERM” - Anedot’s UTM Term field
“SRCECODE” - Anedot’s Source Code field
“EVENT” - “Anedot: Submission Completed” (for AP donations and submissions)
“AMOUNT” - Donation Amount (0 if lead page)
“DONATEDATE”- Submission date
“DONATEURL” - Page URL
“FUNDALLOC” - Fund ID and Amount
“OPTINPHONE” - Anedot’s Communications Consent - Phone field
“OPTINEMAIL” - Anedot’s Communications Consent - Email field
All Custom Fields added to an Action Page and saved on the submission can be relayed along with the standard data. In order for you to see Custom Field data in MailChimp, the Merge Tag name MUST be identical to the tag name we send in the data, which will be reformatted from the Custom Field Label as follows:
- Locate your Custom Field Label within the Action Page Builder. Select Form, then edit your Custom Field.
- Remove all spaces and special characters.
- Only include the first 10 characters and use uppercase lettering.
  - Example:
    - Custom Field Label: “Which feature would you like to learn more about?”
    - Merge Tag name sent to MailChimp: WHICHFEATU
- This is done to format the names following MailChimp standards and validations.
- Tip: If you have multiple Custom Field Labels that begin with the same first 10 characters, you may need to update the additional Custom Field Labels to have unique characters within the first 10 characters.

If there are 5 failed relay attempts in a row, the integration is marked “inactive” and no longer attempts relays.

Custom Fields

All Custom Fields added to an Action Page and saved on the submission can be relayed along with the standard data. In order for you to see Custom Field data in Mailchimp, care must be taken to include the additional Merge Tags as noted in the Guide above.

The Merge Tag name MUST be identical to the tag name we send in the data, which will be reformatted from the Custom Field Label as follows:

Locate your Custom Field Label within the Action Page Builder. Select Form, then edit your Custom Field.
Remove all spaces and special characters.
Only include the first 10 characters and use uppercase lettering.

Example:

Custom Field Label : "Which feature would you like to learn more about?"
Merge Tag name sent to Mailchimp: WHICHFEATU

This is done to format the names following Mailchimp standards and validations.

If you have multiple Custom Field Labels that begin with the same first 10 characters, you may need to update the additional Custom Field Labels to have unique characters within the first 10 characters.

Field Mapping

Anedot Field Name	MailChimp Tag Name
firstName	FNAME
lastName	LNAME
phone	PHONE
address `{`line_1`}`	STREET
address `{`line_2`}`	STREET2
address `city`	CITY
address `region`	STATE
address `postal\_code`	ZIPCODE
utmCodes `campaign`**	UTMCAMPGN
utmCodes `content`**	UTMCONTENT
utmCodes `medium`**	UTMMEDIUM
utmCodes `source`**	UTMSOURCE
utmCodes `term`**	UTMTERM
source_code	SRCECODE
“Anedot: Submission Completed” (for AP donations and submissions)	EVENT
donation_amount (0 if lead page)	AMOUNT
Submission date	DONATEDATE
Action Page’s URL	DONATEURL
Fund ID and Amount	FUNDALLOC
communications_consent_phone (“true” or “false”)	OPTINPHONE
communications_consent_email (“true” or “false”)	OPTINEMAIL

**UTM fields can be added to the Page URL in the AP Builder.

Payload Data

Request Headers

`{``}`

Request Body

`{`  
"merge_fields": `{`  
"CITY": "New Orleans",  
"EVENT": "Anedot: Submission Completed",  
"FNAME": "Annie",  
"LNAME": "Dot",  
"PHONE": "8765678987",  
"STATE": "LA",  
"AMOUNT": "100.0",  
"STREET": "1340 Poydras St",  
"STREET2": "",  
"UTMTERM": "",  
"ZIPCODE": "70112",  
"BIRTHDAY": "",  
"SRCECODE": "",  
"DONATEURL": "https://secure.anedot-sandbox.com/09388ffc-9f3f-43ee-855a-1f70c7a9b764/cab0834d-ad6d-4177-8125-1da2c194f5ef",  
"FUNDALLOC": "InternalIdentifier:1001,Amount:100.0",  
"UTMCAMPGN": "",  
"UTMMEDIUM": "",  
"UTMSOURCE": "",  
"DONATEDATE": "05/05/2023",  
"UTMCONTENT": ""  
`}`,  
"email_address": [[email protected]](/cdn-cgi/l/email-protection)",  
"status_if_new": "subscribed"  
`}`

Response Body (Success)

`{`  
"id": "96e28bd38b0f19d052922a4aadc6d539",  
"vip": false,  
"tags": [],  
"stats": `{`  
"avg_open_rate": 0,  
"avg_click_rate": 0  
`}`,  
"_links": [`{`  
"rel": "self",  
"href": "https://us20.api.mailchimp.com/3.0/lists/c90e84a68f/members/96e28bd38b0f19d052922a4aadc6d539",  
"method": "GET",  
"targetSchema": "https://us20.api.mailchimp.com/schema/3.0/Definitions/Lists/Members/Response.json"  
`}`, `{`  
"rel": "parent",  
"href": "https://us20.api.mailchimp.com/3.0/lists/c90e84a68f/members",  
"method": "GET",  
"schema": "https://us20.api.mailchimp.com/schema/3.0/Paths/Lists/Members/Collection.json",  
"targetSchema": "https://us20.api.mailchimp.com/schema/3.0/Definitions/Lists/Members/CollectionResponse.json"  
`}`, `{`  
"rel": "update",  
"href": "https://us20.api.mailchimp.com/3.0/lists/c90e84a68f/members/96e28bd38b0f19d052922a4aadc6d539",  
"method": "PATCH",  
"schema": "https://us20.api.mailchimp.com/schema/3.0/Definitions/Lists/Members/PATCH.json",  
"targetSchema": "https://us20.api.mailchimp.com/schema/3.0/Definitions/Lists/Members/Response.json"  
`}`, `{`  
"rel": "upsert",  
"href": "https://us20.api.mailchimp.com/3.0/lists/c90e84a68f/members/96e28bd38b0f19d052922a4aadc6d539",  
"method": "PUT",  
"schema": "https://us20.api.mailchimp.com/schema/3.0/Definitions/Lists/Members/PUT.json",  
"targetSchema": "https://us20.api.mailchimp.com/schema/3.0/Definitions/Lists/Members/Response.json"  
`}`, `{`  
"rel": "delete",  
"href": "https://us20.api.mailchimp.com/3.0/lists/c90e84a68f/members/96e28bd38b0f19d052922a4aadc6d539",  
"method": "DELETE"  
`}`, `{`  
"rel": "activity",  
"href": "https://us20.api.mailchimp.com/3.0/lists/c90e84a68f/members/96e28bd38b0f19d052922a4aadc6d539/activity",  
"method": "GET",  
"targetSchema": "https://us20.api.mailchimp.com/schema/3.0/Definitions/Lists/Members/Activity/Response.json"  
`}`, `{`  
"rel": "goals",  
"href": "https://us20.api.mailchimp.com/3.0/lists/c90e84a68f/members/96e28bd38b0f19d052922a4aadc6d539/goals",  
"method": "GET",  
"targetSchema": "https://us20.api.mailchimp.com/schema/3.0/Definitions/Lists/Members/Goals/Response.json"  
`}`, `{`  
"rel": "notes",  
"href": "https://us20.api.mailchimp.com/3.0/lists/c90e84a68f/members/96e28bd38b0f19d052922a4aadc6d539/notes",  
"method": "GET",  
"targetSchema": "https://us20.api.mailchimp.com/schema/3.0/Definitions/Lists/Members/Notes/CollectionResponse.json"  
`}`, `{`  
"rel": "events",  
"href": "https://us20.api.mailchimp.com/3.0/lists/c90e84a68f/members/96e28bd38b0f19d052922a4aadc6d539/events",  
"method": "POST",  
"targetSchema": "https://us20.api.mailchimp.com/schema/3.0/Definitions/Lists/Members/Events/POST.json"  
`}`, `{`  
"rel": "delete_permanent",  
"href": "https://us20.api.mailchimp.com/3.0/lists/c90e84a68f/members/96e28bd38b0f19d052922a4aadc6d539/actions/delete-permanent",  
"method": "POST"  
`}`],  
"ip_opt": "52.13.182.211",  
"source": "API - Generic",  
"status": "subscribed",  
"web_id": 600306575,  
"list_id": "c90e84a68f",  
"language": "",  
"location": `{`  
"dstoff": 0,  
"gmtoff": 0,  
"region": "",  
"latitude": 0,  
"timezone": "",  
"longitude": 0,  
"country_code": ""  
`}`,  
"full_name": "Annie Dot",  
"interests": `{`  
"2c37dcdb40": false,  
"6c3e2d4b9b": false  
`}`,  
"ip_signup": "",  
"contact_id": "5f55b3c36ed692ad1a5da38edc8ffa2d",  
"email_type": "html",  
"tags_count": 0,  
"email_client": "",  
"last_changed": "2023-05-08T17:15:13+00:00",  
"merge_fields": `{`  
"CITY": "New Orleans",  
"EVENT": "Anedot: Submission Completed",  
"FNAME": "Annie",  
"LNAME": "Dot",  
"PHONE": "8765678987",  
"STATE": "LA",  
"AMOUNT": 100,  
"STREET": "1340 Poydras St",  
"STREET2": "",  
"UTMTERM": "",  
"ZIPCODE": "70112",  
"SRCECODE": "",  
"DONATEURL": "https://secure.anedot-sandbox.com/09388ffc-9f3f-43ee-855a-1f70c7a9b764/cab0834d-ad6d-4177-8125-1da2c194f5ef",  
"FUNDALLOC": "InternalIdentifier:1001,Amount:100.0",  
"UTMCAMPGN": "",  
"UTMMEDIUM": "",  
"UTMSOURCE": "",  
"DONATEDATE": "2023-05-05",  
"MYLABELFIE": "",  
"UTMCONTENT": ""  
`}`,  
"email_address": "[[email protected]](/cdn-cgi/l/email-protection)",  
"member_rating": 2,  
"timestamp_opt": "2022-09-02T21:08:21+00:00",  
"unique_email_id": "b3ed7ab68f",  
"timestamp_signup": "",  
"consents_to_one_to_one_messaging": true  
`}`

Response Body (Failure 1)

`{`  
"type": "https://mailchimp.com/developer/marketing/docs/errors/",  
"title": "Resource Not Found",  
"detail": "The requested resource could not be found.",  
"status": 404,  
"instance": "3b8bda84-fdad-22ea-6fec-9ae4c79379ca"  
`}`

Response Body (Failure 2)

`{`  
"type": "https://mailchimp.com/developer/marketing/docs/errors/",  
"title": "API Key Invalid",  
"detail": "Your API key may be invalid, or you've attempted to access the wrong datacenter.",  
"status": 401,  
"instance": "207e182a-1468-3455-a18f-41d286d25188"  
`}`

Response Body (Error)

`{``}`

Response Status (Success)

Response Status (Failure 1)

Response Status (Failure 2)

Response Status (Error)

null

Campaign Monitor Campaign Solutions HubSpot Klaviyo Email Octopus

Setup

Data Relays

Custom Fields

Field Mapping

Payload Data

Request Headers​

Request Body​

Response Body (Success)​

Response Body (Failure 1)​

Response Body (Failure 2)​

Response Body (Error)​

Response Status (Success)​

Response Status (Failure 1)​

Response Status (Failure 2)​

Response Status (Error)​