{
    "componentChunkName": "component---node-modules-rocketseat-gatsby-theme-docs-core-src-templates-docs-query-js",
    "path": "/docs/destinations/marketing/mailchimp/",
    "result": {"data":{"mdx":{"id":"d79f2f9a-1da6-5b66-8a2a-080ede926674","excerpt":"Mailchimp Mailchimp  is a popular email marketing automation platform used worldwide by thousands of businesses. Built specially for eCommerce and retail…","fields":{"slug":"/docs/destinations/marketing/mailchimp/"},"frontmatter":{"title":"Mailchimp","description":"Step-by-step guide to add people to your Mailchimp list using RudderStack","image":null,"disableTableOfContents":null},"body":"var _excluded = [\"components\"];\n\nfunction _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }\n\nfunction _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }\n\nfunction _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }\n\n/* @jsxRuntime classic */\n\n/* @jsx mdx */\nvar _frontmatter = {\n  \"title\": \"Mailchimp\",\n  \"description\": \"Step-by-step guide to add people to your Mailchimp list using RudderStack\"\n};\nvar layoutProps = {\n  _frontmatter: _frontmatter\n};\nvar MDXLayout = \"wrapper\";\nreturn function MDXContent(_ref) {\n  var components = _ref.components,\n      props = _objectWithoutProperties(_ref, _excluded);\n\n  return mdx(MDXLayout, _extends({}, layoutProps, props, {\n    components: components,\n    mdxType: \"MDXLayout\"\n  }), mdx(\"h1\", {\n    \"id\": \"mailchimp\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h1\",\n    \"href\": \"#mailchimp\",\n    \"aria-label\": \"mailchimp permalink\",\n    \"className\": \"anchor before\"\n  }, mdx(\"svg\", {\n    parentName: \"a\",\n    \"aria-hidden\": \"true\",\n    \"focusable\": \"false\",\n    \"height\": \"16\",\n    \"version\": \"1.1\",\n    \"viewBox\": \"0 0 16 16\",\n    \"width\": \"16\"\n  }, mdx(\"path\", {\n    parentName: \"svg\",\n    \"fillRule\": \"evenodd\",\n    \"d\": \"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"\n  }))), \"Mailchimp\"), mdx(\"p\", null, mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"https://mailchimp.com/\"\n  }, \"Mailchimp\"), \" is a popular email marketing automation platform used worldwide by thousands of businesses. Built specially for eCommerce and retail, Mailchimp allows you to build your audience and send them personalized campaign and marketing messages through web or mobile.\"), mdx(\"p\", null, \"RudderStack allows you to add people to your Mailchimp list via a simple \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"identify\"), \" call.\"), mdx(\"div\", {\n    className: \"successBlock\"\n  }, mdx(\"strong\", null, \"Find the open-source transformer code for this destination in our \", mdx(\"a\", {\n    href: \"https://github.com/rudderlabs/rudder-transformer/tree/master/v0/destinations/mailchimp\"\n  }, \"GitHub repo\"), \".\")), mdx(\"h2\", {\n    \"id\": \"getting-started\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h2\",\n    \"href\": \"#getting-started\",\n    \"aria-label\": \"getting started permalink\",\n    \"className\": \"anchor before\"\n  }, mdx(\"svg\", {\n    parentName: \"a\",\n    \"aria-hidden\": \"true\",\n    \"focusable\": \"false\",\n    \"height\": \"16\",\n    \"version\": \"1.1\",\n    \"viewBox\": \"0 0 16 16\",\n    \"width\": \"16\"\n  }, mdx(\"path\", {\n    parentName: \"svg\",\n    \"fillRule\": \"evenodd\",\n    \"d\": \"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"\n  }))), \"Getting Started\"), mdx(\"p\", null, \"Before configuring Mailchimp as a destination in RudderStack, please make sure that the source platform is supported by Mailchimp. You can refer to the following table to do so:\"), mdx(\"table\", null, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": \"left\"\n  }, mdx(\"strong\", {\n    parentName: \"th\"\n  }, \"Connection Mode\")), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": \"left\"\n  }, mdx(\"strong\", {\n    parentName: \"th\"\n  }, \"Web\")), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": \"left\"\n  }, mdx(\"strong\", {\n    parentName: \"th\"\n  }, \"Mobile\")), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": \"left\"\n  }, mdx(\"strong\", {\n    parentName: \"th\"\n  }, \"Server\")))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": \"left\"\n  }, mdx(\"strong\", {\n    parentName: \"td\"\n  }, \"Device mode\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": \"left\"\n  }, \"-\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": \"left\"\n  }, \"-\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": \"left\"\n  }, \"-\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": \"left\"\n  }, mdx(\"strong\", {\n    parentName: \"td\"\n  }, \"Cloud mode\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": \"left\"\n  }, mdx(\"strong\", {\n    parentName: \"td\"\n  }, \"Supported\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": \"left\"\n  }, mdx(\"strong\", {\n    parentName: \"td\"\n  }, \"Supported\")), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": \"left\"\n  }, mdx(\"strong\", {\n    parentName: \"td\"\n  }, \"Supported\"))))), mdx(\"div\", {\n    className: \"infoBlock\"\n  }, mdx(\"p\", null, \"To know more about the difference between Cloud mode and Device mode in RudderStack, read the \", mdx(\"a\", {\n    href: \"https://rudderstack.com/docs/connections/rudderstack-connection-modes/\"\n  }, \"RudderStack connection modes\"), \" guide.\")), mdx(\"p\", null, \"Once you have confirmed that Mailchimp supports the source type, perform the steps below:\"), mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"From your \", mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"https://app.rudderlabs.com/\"\n  }, \"RudderStack dashboard\"), \", add the source and Mailchimp as a destination.\")), mdx(\"div\", {\n    className: \"infoBlock\"\n  }, mdx(\"p\", null, \"Please follow our guide on \", mdx(\"a\", {\n    href: \"https://rudderstack.com/docs/connections/adding-source-and-destination-rudderstack/\"\n  }, \"How to Add a Source and Destination in RudderStack\"), \" to add a source and destination in RudderStack.\")), mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"Give a suitable name to the destination, and then click on \", mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Next\"), \". You should then see the following screen:\")), mdx(\"undefined\", null, mdx(\"span\", {\n    \"className\": \"gatsby-resp-image-wrapper\",\n    \"style\": {\n      \"position\": \"relative\",\n      \"display\": \"block\",\n      \"marginLeft\": \"auto\",\n      \"marginRight\": \"auto\",\n      \"maxWidth\": \"696px\"\n    }\n  }, \"\\n      \", mdx(\"span\", {\n    parentName: \"span\",\n    \"className\": \"gatsby-resp-image-background-image\",\n    \"style\": {\n      \"paddingBottom\": \"70%\",\n      \"position\": \"relative\",\n      \"bottom\": \"0\",\n      \"left\": \"0\",\n      \"backgroundImage\": \"url('data:image/webp;base64,UklGRmQAAABXRUJQVlA4IFgAAAAwAwCdASoUAA4APjEUiEKiISEYBAAgAwS0gAAuDbg0tyqAAP7/tar+DpSXi/n6ah/NBp+fSPIOMte+gBUX4LxXgJgIiyKOqgKwAQCSTgp9jB/Uw18lwgAA')\",\n      \"backgroundSize\": \"cover\",\n      \"display\": \"block\"\n    }\n  }), \"\\n  \", mdx(\"picture\", {\n    parentName: \"span\"\n  }, \"\\n          \", mdx(\"source\", {\n    parentName: \"picture\",\n    \"srcSet\": [\"/static/5a188f6cce913e1318f68ea32a5ce447/cbea2/image%20(72).webp 240w\", \"/static/5a188f6cce913e1318f68ea32a5ce447/42669/image%20(72).webp 480w\", \"/static/5a188f6cce913e1318f68ea32a5ce447/657d2/image%20(72).webp 696w\"],\n    \"sizes\": \"(max-width: 696px) 100vw, 696px\",\n    \"type\": \"image/webp\"\n  }), \"\\n          \", mdx(\"source\", {\n    parentName: \"picture\",\n    \"srcSet\": [\"/static/5a188f6cce913e1318f68ea32a5ce447/5243c/image%20(72).png 240w\", \"/static/5a188f6cce913e1318f68ea32a5ce447/ab158/image%20(72).png 480w\", \"/static/5a188f6cce913e1318f68ea32a5ce447/871fd/image%20(72).png 696w\"],\n    \"sizes\": \"(max-width: 696px) 100vw, 696px\",\n    \"type\": \"image/png\"\n  }), \"\\n          \", mdx(\"img\", {\n    parentName: \"picture\",\n    \"className\": \"gatsby-resp-image-image\",\n    \"src\": \"/static/5a188f6cce913e1318f68ea32a5ce447/871fd/image%20(72).png\",\n    \"alt\": \"image  72 \",\n    \"title\": \"image  72 \",\n    \"loading\": \"lazy\",\n    \"decoding\": \"async\",\n    \"style\": {\n      \"width\": \"100%\",\n      \"height\": \"100%\",\n      \"margin\": \"0\",\n      \"verticalAlign\": \"middle\",\n      \"position\": \"absolute\",\n      \"top\": \"0\",\n      \"left\": \"0\"\n    }\n  }), \"\\n        \"), \"\\n    \"), mdx(\"span\", {\n    \"className\": \"imageTitle\"\n  }, \"Mailchimp Connection Settings screen\")), mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"Enter the relevant information in the fields such as the \", mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Mailchimp API Key\"), \", \", mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Audience ID\"), \" and \", mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"DataCenter ID\"), \". Then, click on \", mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Next\"), \".\")), mdx(\"div\", {\n    className: \"infoBlock\"\n  }, mdx(\"p\", null, \"It is recommended that you create a new API key for your RudderStack destination. Mailchimp restricts each API key to a maximum of 10 concurrent requests. Hence, creating a dedicated key for RudderStack ensures maximum throughput for the outgoing calls. Please read more about the API keys by going to \", mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"https://mailchimp.com/help/about-api-keys/\"\n  }, \"Mailchimp\\u2019s documentation\"), \".\")), mdx(\"h2\", {\n    \"id\": \"identify\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h2\",\n    \"href\": \"#identify\",\n    \"aria-label\": \"identify permalink\",\n    \"className\": \"anchor before\"\n  }, mdx(\"svg\", {\n    parentName: \"a\",\n    \"aria-hidden\": \"true\",\n    \"focusable\": \"false\",\n    \"height\": \"16\",\n    \"version\": \"1.1\",\n    \"viewBox\": \"0 0 16 16\",\n    \"width\": \"16\"\n  }, mdx(\"path\", {\n    parentName: \"svg\",\n    \"fillRule\": \"evenodd\",\n    \"d\": \"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"\n  }))), \"Identify\"), mdx(\"p\", null, \"The \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"identify\"), \" call captures the details about the visiting user along with the properties associated with that user. For more information, please refer to our \", mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"https://rudderstack.com/docs/rudderstack-api/api-specification/rudderstack-spec/\"\n  }, \"RudderStack API Specification\"), \" documentation.\"), mdx(\"h3\", {\n    \"id\": \"adding-or-updating-a-user\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#adding-or-updating-a-user\",\n    \"aria-label\": \"adding or updating a user permalink\",\n    \"className\": \"anchor before\"\n  }, mdx(\"svg\", {\n    parentName: \"a\",\n    \"aria-hidden\": \"true\",\n    \"focusable\": \"false\",\n    \"height\": \"16\",\n    \"version\": \"1.1\",\n    \"viewBox\": \"0 0 16 16\",\n    \"width\": \"16\"\n  }, mdx(\"path\", {\n    parentName: \"svg\",\n    \"fillRule\": \"evenodd\",\n    \"d\": \"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"\n  }))), \"Adding or updating a user\"), mdx(\"p\", null, \"Let us consider a sample \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"identify\"), \" call in RudderStack:\"), mdx(\"pre\", null, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-javascript\"\n  }, \"rudderanalytics.identify(\\\"user123\\\", {\\n  firstName: \\\"John\\\",\\n  lastName: \\\"Doe\\\",\\n  email: \\\"namesurname@domain.com\\\"\\n});\\n\")), mdx(\"p\", null, \"Every time an \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"identify\"), \" call is made with an email address included, RudderStack performs the following steps:\"), mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"RudderStack first checks with Mailchimp whether that specific email address exists for the \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"listId\"), \" provided in the destination settings.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"If the email address does not exist in the list, RudderStack will subscribe the associated user to the list immediately. If the \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"doubleOptIn\"), \" setting is enabled, Mailchimp will send a confirmation email to that user, and that email will be tagged with a subscriber status of \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"pending\"), \". The subscriber status automatically changes to \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"subscribed\"), \" once the user confirms the email.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"If the user already has a subscriber status such as \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"pending\"), \", \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"subscribed\"), \", \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"unsubscribed\"), \" or \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"cleaned\"), \", RudderStack will \", mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"not\"), \" resubscribe them, but only update their associated user traits.\")), mdx(\"div\", {\n    className: \"infoBlock\"\n  }, mdx(\"p\", null, \"For the \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"identify\"), \" call in RudderStack, email is a required field. The rest of the fields must match the \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Merge Field\"), \" tag in Mailchimp.\")), mdx(\"h3\", {\n    \"id\": \"using-custom-merge-fields-in-rudderstack\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#using-custom-merge-fields-in-rudderstack\",\n    \"aria-label\": \"using custom merge fields in rudderstack permalink\",\n    \"className\": \"anchor before\"\n  }, mdx(\"svg\", {\n    parentName: \"a\",\n    \"aria-hidden\": \"true\",\n    \"focusable\": \"false\",\n    \"height\": \"16\",\n    \"version\": \"1.1\",\n    \"viewBox\": \"0 0 16 16\",\n    \"width\": \"16\"\n  }, mdx(\"path\", {\n    parentName: \"svg\",\n    \"fillRule\": \"evenodd\",\n    \"d\": \"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"\n  }))), mdx(\"strong\", {\n    parentName: \"h3\"\n  }, \"Using custom merge fields in RudderStack\")), mdx(\"p\", null, \"To send custom merge fields or user traits to Mailchimp, please follow these steps:\"), mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"Create the merge field in Mailchimp for every trait you want sent to it.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"When you make the \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"identify\"), \" call, the keys that match the traits above will automatically appear in your Mailchimp list.\")), mdx(\"div\", {\n    className: \"infoBlock\"\n  }, mdx(\"p\", null, \"The \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"identify\"), \" call will \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"not change\"), \" in this case.\")), mdx(\"h3\", {\n    \"id\": \"overriding-listid\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#overriding-listid\",\n    \"aria-label\": \"overriding listid permalink\",\n    \"className\": \"anchor before\"\n  }, mdx(\"svg\", {\n    parentName: \"a\",\n    \"aria-hidden\": \"true\",\n    \"focusable\": \"false\",\n    \"height\": \"16\",\n    \"version\": \"1.1\",\n    \"viewBox\": \"0 0 16 16\",\n    \"width\": \"16\"\n  }, mdx(\"path\", {\n    parentName: \"svg\",\n    \"fillRule\": \"evenodd\",\n    \"d\": \"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"\n  }))), \"Overriding \", mdx(\"inlineCode\", {\n    parentName: \"h3\"\n  }, \"listId\")), mdx(\"p\", null, \"If you have multiple lists that your users can subscribe to, you can override the default \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"listId\"), \"as a parameter to Mailchimp.\"), mdx(\"p\", null, \"Consider the following code snippet:\"), mdx(\"pre\", null, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-javascript\"\n  }, \"rudderanalytics.identify(\\n  \\\"userId123\\\",\\n  {\\n    email: \\\"namesurname@domain.com\\\"\\n  },\\n  {\\n    integrations: {\\n      MailChimp: {\\n        listId: \\\"esf1rd234a\\\"\\n      }\\n    }\\n  }\\n);\\n\")), mdx(\"p\", null, \"In the example above, we override the default \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"listId\"), \" with the \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"listId\"), \" as \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"esf1rd234a\")), mdx(\"h3\", {\n    \"id\": \"updating-the-subscription-status\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#updating-the-subscription-status\",\n    \"aria-label\": \"updating the subscription status permalink\",\n    \"className\": \"anchor before\"\n  }, mdx(\"svg\", {\n    parentName: \"a\",\n    \"aria-hidden\": \"true\",\n    \"focusable\": \"false\",\n    \"height\": \"16\",\n    \"version\": \"1.1\",\n    \"viewBox\": \"0 0 16 16\",\n    \"width\": \"16\"\n  }, mdx(\"path\", {\n    parentName: \"svg\",\n    \"fillRule\": \"evenodd\",\n    \"d\": \"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"\n  }))), \"Updating the subscription status\"), mdx(\"p\", null, \"RudderStack gives you the option of manually updating the subscription status of a user. Simply pass on an additional parameter to Mailchimp called \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"subscriptionStatus\"), \".\"), mdx(\"p\", null, \"An example of how to do this is as shown in the code snippet below:\"), mdx(\"pre\", null, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-javascript\"\n  }, \"rudderanalytics.identify(\\n  \\\"userId123\\\",\\n  {\\n    email: \\\"namesurname@domain.com\\\"\\n  },\\n  {\\n    integrations: {\\n      MailChimp: {\\n        subscriptionStatus: \\\"unsubscribed\\\"\\n      }\\n    }\\n  }\\n);\\n\")), mdx(\"div\", {\n    className: \"infoBlock\"\n  }, mdx(\"p\", null, \"Please note that this setting will \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"NOT\"), \" work for new users. New users will always have the subscription status set for them as either \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"pending\"), \" or \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"subscribed\"), \" , depending on the set \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"doubleOptIn\"), \" setting.\")), mdx(\"h2\", {\n    \"id\": \"faqs\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h2\",\n    \"href\": \"#faqs\",\n    \"aria-label\": \"faqs permalink\",\n    \"className\": \"anchor before\"\n  }, mdx(\"svg\", {\n    parentName: \"a\",\n    \"aria-hidden\": \"true\",\n    \"focusable\": \"false\",\n    \"height\": \"16\",\n    \"version\": \"1.1\",\n    \"viewBox\": \"0 0 16 16\",\n    \"width\": \"16\"\n  }, mdx(\"path\", {\n    parentName: \"svg\",\n    \"fillRule\": \"evenodd\",\n    \"d\": \"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"\n  }))), \"FAQs\"), mdx(\"h3\", {\n    \"id\": \"where-do-i-get-the-mailchimp-api-key\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#where-do-i-get-the-mailchimp-api-key\",\n    \"aria-label\": \"where do i get the mailchimp api key permalink\",\n    \"className\": \"anchor before\"\n  }, mdx(\"svg\", {\n    parentName: \"a\",\n    \"aria-hidden\": \"true\",\n    \"focusable\": \"false\",\n    \"height\": \"16\",\n    \"version\": \"1.1\",\n    \"viewBox\": \"0 0 16 16\",\n    \"width\": \"16\"\n  }, mdx(\"path\", {\n    parentName: \"svg\",\n    \"fillRule\": \"evenodd\",\n    \"d\": \"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"\n  }))), \"Where do I get the Mailchimp API Key?\"), mdx(\"p\", null, \"To get the Mailchimp API Key, log in to Mailchimp, and go to \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Account\"), \" - \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Extras\"), \" - \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"API Keys\")), mdx(\"h3\", {\n    \"id\": \"where-do-i-get-the-mailchimp-audience-id\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#where-do-i-get-the-mailchimp-audience-id\",\n    \"aria-label\": \"where do i get the mailchimp audience id permalink\",\n    \"className\": \"anchor before\"\n  }, mdx(\"svg\", {\n    parentName: \"a\",\n    \"aria-hidden\": \"true\",\n    \"focusable\": \"false\",\n    \"height\": \"16\",\n    \"version\": \"1.1\",\n    \"viewBox\": \"0 0 16 16\",\n    \"width\": \"16\"\n  }, mdx(\"path\", {\n    parentName: \"svg\",\n    \"fillRule\": \"evenodd\",\n    \"d\": \"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"\n  }))), \"Where do I get the Mailchimp Audience ID?\"), mdx(\"p\", null, \"You can find the Mailchimp Audience ID by logging in to Mailchimp and navigating to \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Audience\"), \" - \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Manage Audience\"), \" - \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Settings\"), \" - \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Audience name and defaults\")), mdx(\"h3\", {\n    \"id\": \"where-do-i-get-the-mailchimp-datacenter-id\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#where-do-i-get-the-mailchimp-datacenter-id\",\n    \"aria-label\": \"where do i get the mailchimp datacenter id permalink\",\n    \"className\": \"anchor before\"\n  }, mdx(\"svg\", {\n    parentName: \"a\",\n    \"aria-hidden\": \"true\",\n    \"focusable\": \"false\",\n    \"height\": \"16\",\n    \"version\": \"1.1\",\n    \"viewBox\": \"0 0 16 16\",\n    \"width\": \"16\"\n  }, mdx(\"path\", {\n    parentName: \"svg\",\n    \"fillRule\": \"evenodd\",\n    \"d\": \"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"\n  }))), \"Where do I get the Mailchimp DataCenter ID?\"), mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"To get the DataCenter ID, please refer to your Mailchimp URL in the browser. For example, if the URL is \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"https://us20.admin.mailchimp.com/lists\"), \", the DataCenter ID is \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"us20\"), \" in this case.\")), mdx(\"h2\", {\n    \"id\": \"contact-us\",\n    \"style\": {\n      \"position\": \"relative\"\n    }\n  }, mdx(\"a\", {\n    parentName: \"h2\",\n    \"href\": \"#contact-us\",\n    \"aria-label\": \"contact us permalink\",\n    \"className\": \"anchor before\"\n  }, mdx(\"svg\", {\n    parentName: \"a\",\n    \"aria-hidden\": \"true\",\n    \"focusable\": \"false\",\n    \"height\": \"16\",\n    \"version\": \"1.1\",\n    \"viewBox\": \"0 0 16 16\",\n    \"width\": \"16\"\n  }, mdx(\"path\", {\n    parentName: \"svg\",\n    \"fillRule\": \"evenodd\",\n    \"d\": \"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"\n  }))), \"Contact Us\"), mdx(\"p\", null, \"If you come across any issues while configuring Mailchimp with RudderStack, please feel free to \", mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"mailto:%20docs@rudderstack.com\"\n  }, \"contact us\"), \". You can also start a conversation in our \", mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"https://rudderstack.com/join-rudderstack-slack-community\"\n  }, \"Slack\"), \" community; we will be happy to talk to you!\"));\n}\n;\nMDXContent.isMDXComponent = true;","headings":[{"depth":1,"value":"Mailchimp"},{"depth":2,"value":"Getting Started"},{"depth":2,"value":"Identify"},{"depth":3,"value":"Adding or updating a user"},{"depth":3,"value":"Using custom merge fields in RudderStack"},{"depth":3,"value":"Overriding listId"},{"depth":3,"value":"Updating the subscription status"},{"depth":2,"value":"FAQs"},{"depth":3,"value":"Where do I get the Mailchimp API Key?"},{"depth":3,"value":"Where do I get the Mailchimp Audience ID?"},{"depth":3,"value":"Where do I get the Mailchimp DataCenter ID?"},{"depth":2,"value":"Contact Us"}]}},"pageContext":{"slug":"/docs/destinations/marketing/mailchimp/","next":{"label":"Home","link":"/docs/home"},"repositoryEditUrl":"","repositoryProvider":""}},
    "staticQueryHashes": ["2501019404"]}