Connect Drupal Webform. Send every lead to Mailchimp.

Connect Drupal Webform to Mailchimp

ClickSyncr sends Drupal Webform submissions to a Mailchimp audience. Connect your account inside the webform, match its fields, and save the handler to prepare new submissions for delivery.

What you need

Use Drupal 10.3 or Drupal 11, Webform 6, and PHP 8.3 or later with OpenSSL. You also need a Mailchimp account, an API key, and a audience to receive subscribers. Keep Webform submission storage enabled and Drupal cron running: the module sends saved delivery requests when cron runs.

Install and open the handler

Install and enable Webform Integration for Mailchimp from Drupal.org. Open Structure > Webforms, choose your form, and select its Mailchimp tab. The tab opens the handler configuration. If more than one matching handler exists, choose the handler you want to edit.

Connect your API key

Paste your key into Mailchimp API key and select Connect. Then choose the Mailchimp audience. The field mapping options load for that destination. To replace a saved key, paste the replacement and connect it before saving the configuration.

Map the fields you collect

Email is required. The remaining fields include the selected audience’s merge fields, using the names configured in that audience. Address fields split into addr1, addr2, city, state, zip, and country. Language, Email format, and interest choices can also appear within the field limit. Map required fields before saving; do not assume that every audience has the same merge tags.

For each destination field, select the matching element from your webform. Start with Email, then review the optional mappings. Check the displayed field types as well as their names so that a date or number is connected to the intended value.

Set consent and subscriber status

Under Consent and delivery, select a Consent checkbox if your form uses one. Once selected, that checkbox must be checked for a submission to be sent to Mailchimp. Leaving it unselected allows valid submissions through without a checkbox condition. Subscriber status offers Active and Unconfirmed. Confirmation email behavior depends on your Mailchimp settings, so test the selected status before accepting signups.

Test a completed submission

Submit the public form using a test contact you control, with the configured consent checkbox checked. After cron runs, open the saved submission’s Mailchimp tab and inspect its delivery result. Check the contact in your selected audience, including each mapped value. If you configured consent, submit another test with it unchecked and confirm that it is not sent.

Resolve connection and mapping errors

“Could not connect to Mailchimp.” Check the API key and reconnect; the error message confirms that the saved mapping has not changed. “Could not load this audience.” Reconnect and select the destination again. If the account has no audiences, create one in Mailchimp, then reconnect.

If saving asks you to refresh fields and audiences, reload them and review the selected sources. A saved submission is not proof of delivery. Read its result before trying again, then correct the reported value or setting. An authorized administrator can use Send again from the submission’s delivery screen.

See the Mailchimp integration overview for the destination’s ClickSyncr page.

Frequently asked questions

What happens to the saved Mailchimp API key if Drupal’s hash salt changes?

The module encrypts the saved Mailchimp credential with a key derived from Drupal’s hash salt. Changing that salt means the old encrypted value cannot be opened with the new key. Reconnect the Mailchimp API key after the change, then test the handler again. A copied database alone does not recreate the encryption context needed to read the saved credential.

Does Send again use the original Mailchimp mapping or the current one?

Send again rebuilds the delivery from the submission’s current saved values and the current handler mapping. The consent rule and handler conditions must still pass. It does not replay the original request unchanged. Review the earlier Mailchimp result before confirming: an unresolved earlier delivery may still complete, and the retry form rejects deliveries already marked accepted or still pending.

How can I tell which mapped fields Mailchimp accepted or dropped?

Open the saved submission’s Mailchimp tab and read the Fields column alongside Delivery state and Reason. When the service returns field details, the module shows how many fields were kept and names dropped fields with their reported reasons. An empty Fields cell means no field summary is available; it does not establish that every mapped value was accepted.