Iubenda logo
Start generating

Documentation

Table of Contents

How to Keep Your Consent Data in Sync Across Different Platforms with iubenda’s 2-Way Sync

Managing consent across different platforms just got easier. With iubenda’s 2-Way Sync for the Consent Database, you can automatically synchronize consent statuses in real-time across all your third-party tools, like CRM platforms (e.g., HubSpot), email marketing tools (e.g., Mailchimp), and more. This two-way synchronization makes it simple to keep your consent data accurate and compliant, all without the need for manual updates or complex coding.

In this guide, we’ll walk you through how to easily set up and manage webhooks for 2-Way Sync, ensuring your consent data is always up-to-date across all your platforms.

Before we get started with the setup, let’s take a look at the key features of the 2-Way Sync system powered by webhooks:

  • 2-Way Sync: More than just a simple webhook feature, this system offers two-way synchronization between your Consent Database and external platforms, including CRMs and email marketing tools. This means that any update to consent data (like a user opting in or out of your newsletter) is automatically reflected across all connected platforms—in both directions.
  • Centralized Privacy Compliance: Manage all your consent preferences from one central hub, helping you comply with privacy regulations effortlessly. This is particularly beneficial for activities like newsletters and lead generation, where data privacy is crucial.
  • Automated Data Management: Whenever changes occur on one platform (e.g., a user unsubscribes in Mailchimp), this system automatically updates all connected platforms (e.g., HubSpot). It also keeps a log of these changes in your Consent Database, saving you time and minimizing the manual effort required to stay compliant.
  • No Custom Code Needed: Streamline your consent management process without the hassle of custom coding or third-party services. This system simplifies integrations, making it accessible for users at any technical level.
  1. Go to Settings: From the iubenda Dashboard, select the project and click the settings icon.
  2. Open Consent Database Webhooks: In the side menu, click on “Consent database webhooks“. This section is your starting point for setting up the synchronization between the Consent Database and your connected platforms.
  3. webhooks iubenda consent database
  4. Activate the Consent Database (If required): If the Consent Database is not yet active, you’ll see a message: “To start setting up webhooks, you first need to activate the Consent Database.” Click Activate Consent Database and follow the prompts.
  5. webhooks iubenda consent database
  6. If your Consent Database is already active, proceed to create a new webhook. You’ll see a description of how webhooks work, with a “+ Create a new webhook” button available to get started.
  7. webhooks iubenda consent database

2. Creating a New Webhook

Setting up a webhook lets you automatically synchronize and notify connected platforms about consent status changes. Here’s how to set one up:

  1. Click “+ Create a new webhook”, this will open the webhook creation modal.
  2. Select the Webhook Type: You’ll see two options at the top:
  3. webhooks iubenda consent database
  • 📥 Inbound: Use this to automatically update your Consent Database when a specific event, like a user consent change, is triggered on an external platform. It reacts to updates made outside the Consent Database (e.g., a user updating their preferences in your CRM or email tool), ensuring those updates are promptly reflected within your database.
  • 📤 Outbound: Use this to notify external systems whenever an event, such as a consent status change, is registered in your Consent Database.

In some cases, the Consent Database can serve as a bridge between two platforms. For example, an inbound webhook can capture consent changes from a platform like Mailchimp, and an outbound webhook can send those updates to another platform, like HubSpot. This allows you to keep all systems in sync through iubenda, without manual intervention.

Let’s go through how to set up each type.

3. How to Set Up an Inbound Webhook

An inbound webhook is used to automatically update the Consent Database when user actions, like consent changes, occur on an external platform. For example, if a user opts in to your newsletter via a form on your website, this change will automatically sync with your Consent Database.

Step-by-Step Instructions

  1. Choose the “Inbound” Tab.

👉 This webhook updates your Consent Database whenever a specific event, like a user opting in or out, is triggered on an external platform.

  1. Specify the Preference to Be Updated:
  • Newsletter (These details are based on the Newsletter Opt-in Booster naming):
    • Use the dropdown to select the preference value (e.g., True for Subscribed, False for Unsuscribed). This refers to the actual value associated with the user’s consent preference in your Consent Database.
    • webhooks iubenda consent database
  • If you wish to use different names and values, choose the ‘Custom’ option below. (This option is needed if you’ve set up custom preferences or values that are specific to what you’re saving in the Consent Database.)
    • Enter your custom preference name (e.g., tosAccepted).
    • Enter the value (e.g., true). Remember, both fields must be filled.
    • webhooks iubenda consent database
  1. Click “Save” to complete the setup and save the webhook.

✅ Your Consent Database will now automatically receive updates whenever the specified event occurs, matching the subject’s email and updating the corresponding consent status.

4. How to Set Up an Outbound Webhook

An outbound webhook sends notifications to external systems (like Mailchimp or your CRM) whenever there’s a change in the Consent Database. This is useful for keeping your platforms updated with the latest consent preferences.

⚠️ Note: To connect to third-party platforms, you will need to use an external integration service like Zapier, N8n, or Make. These tools act as intermediaries, receiving the webhook data and then forwarding it to the desired platform (e.g., Mailchimp, HubSpot) to keep everything in sync.

💡 You can also check the guide on integrating with services like Zapier and Make for additional help.

Step-by-Step Instructions

  1. Select the “Outbound” Tab.

👉 This webhook sends notifications to external systems when consent status changes.

  1. Specify the Endpoint URL: Enter the URL where updates should be sent. (Note: This is a required field.)
  2. Choose the Preference to Track:
  • Newsletter (These details are based on the Newsletter Opt-in Booster naming):
    • Optionally, select “Set for specific preference value only” to track changes for a specific value and use the dropdown to select the preference value (e.g., True for Subscribed, False for Unsubscribed).
    • webhooks iubenda consent database
  • If you wish to use different names and values, select the ‘Custom’ option below.”
    • Enter a custom preference name (e.g., tosAccepted).
    • If you only want to send notifications for specific values, check “Set for specific preference value only” and enter the value (e.g., true).
    • webhooks iubenda consent database
  1. Click “Save” to create the outbound webhook.

✅ It will now notify the specified platform whenever the chosen consent changes occur in the Consent Database.

5. Managing Webhooks in the Consent Database Dashboard

Activating or Pausing Webhooks

Each webhook (inbound or outbound) has a toggle switch that allows you to enable or pause updates. This control is helpful when you need to temporarily stop syncing data.

Editing a Webhook

Find the webhook you want to modify and click the “Edit” button. This opens the webhook setup interface, where you can change the endpoint URL, tracked preferences, or any other settings. Click Save to apply the updates.

webhooks iubenda consent database

Deleting a Webhook

To delete a webhook, click the trash icon next to it. A confirmation prompt will appear to ensure you want to proceed. Click “Confirm” to permanently remove the webhook.

💡 Note: Once deleted, a webhook cannot be recovered, so make sure to double-check before confirming.

🔍 Example Use Case: Syncing Your Newsletter and CRM

Suppose you use Mailchimp for newsletters and HubSpot as your CRM. Here’s how you can sync consent preferences across both platforms using iubenda’s webhooks:

  1. Inbound Webhook (e.g. Mailchimp to iubenda): Set up an inbound webhook in iubenda to capture subscribe or unsubscribe events from Mailchimp. This updates the Consent Database automatically.
  2. Outbound Webhook (e.g. iubenda to HubSpot):: Create an outbound webhook from iubenda to HubSpot. Using a service like Zapier, N8n, or Make, you can forward consent status updates to HubSpot, ensuring the CRM always has the most current data.

With this 2-way synchronization, your consent preferences are automatically updated across both Mailchimp and HubSpot—saving you time and reducing manual work. This means, your Consent Database keeps a record of all changes, helping you stay compliant with privacy regulations.

Webhooks in iubenda’s Consent Database are a powerful way to keep your marketing tools, CRMs, and other platforms updated with the latest consent preferences. With just a few clicks, you can ensure that user preferences are always in sync across your platforms, helping you maintain compliance and streamline your processes.

Set up 2-Way Sync Now to Simplify Consent Management!

Stay compliant effortlessly and start syncing data across all your platforms with ease.

Get started today!