Mailchimp

Getting started? Check out How To Connect Forms to Mailchimp guide first.

TypeDescription
addOrUpdateContactAdds or updates a contact

Add or update contact

Adds or updates a contact in a Mailchimp audience. Under the hood, this action calls the add or update a list member API endpoint. If the call fails, we'll retry it for you.

KeyTypeDefaultDescription
audienceString@mailchimp-audienceYour Mailchimp audience ID (a static value or a @secret reference)
apiKeyString@mailchimp-api-keyThe name of the StaticKit secret holding your API key (must be a @secret reference)
statusIfNewStringsubscribedThe contact's status if they are new (possible values: subscribed, unsubscribed, cleaned, pending, transaction)
mergeFieldsObject{}A mapping of Mailchimp merge tags to form field names
emailAddressFieldStringemailThe email address field name

Usage Example

{
  "forms": {
    "contact": {
      "name": "Contact Form",
      "actions": [
        {
          "app": "mailchimp",
          "type": "addOrUpdateContact",
          "audience": "8djs8fg8d",
          "mergeFields": {
            "FNAME": "first_name"
          }
        }
      ]
    }
  }
}