How to Set Up Webhooks

This feature requires Manager user level or higher.

Webhooks collect data when your list changes, and can then send updates to an application outside of MailChimp.

For example, you might set up a webhook to notify your CRM system when events like subscribes, unsubscribes, and profile changes happened in your MailChimp list.

In this article, you'll learn how to set up webhooks.

Before You Start

Here are some things to know before you start this process.

  • This is an advanced feature and is recommended for users familiar with custom coding. Contact your developer, or hire a MailChimp Expert if you need assistance.
  • You or your developer will need to set up a callback URL in your application or integration to deliver webhook requests to.
  • To preview what different types of webhook events will look like after they’re triggered, create a test URL with Request Bin
  • Learn about example webhook requests and responses in our API Docs.

Set Up WebHooks

  1. Navigate to the Lists page.
  2. Click the drop-down menu next to the list you want to work with, and choose Settings.

    Select Settings

  3. On the Settings page, click Webhooks.
  4. Click Create New Webhook.

    Add Webhook

  5. In the Callback URL field, type the URL from your integration or application where you want to send webhook requests. This URL will receive data about events going on in your MailChimp list.

    Callback URL
    If you don’t have a callback URL yet, contact your developer or hire an expert to set it up.

  6. Check the boxes next to each update type to choose the events that will trigger your webhook.

    Types of updates

  7. Click Save.

After the URL is saved, the webhook will notify your application of any events.

Troubleshoot Webhooks

If your webhook isn’t working, run your callback URL through a site like web sniffer to make sure it’s responsive to GET requests. If there’s an issue, contact your developer to troubleshoot.

Was this article helpful?
What can we do to improve articles like this?

Related Articles

Technical Support