Skip to main content

What this is

An Insider Webhook source brings event data into Zeotap CDP from your Insider account — page views, user events, email and messaging events, and the attributes you attach to them. This page covers the Zeotap CDP half of the integration: creating the source, and collecting the two values the webhook needs. The webhook itself is configured inside Insider afterwards, in Implement an Insider source. Create the source first — the API URL and write key it generates are what you paste into Insider. To send data the other way, out of Zeotap CDP to Insider for activation and targeting, use the Insider destination instead.

Prerequisites

  • Access to the Sources application under Integrate in the Zeotap CDP App.
  • An Insider account with access to Integrations > External Integrations, where the webhook is configured in the next step of the integration.

Create the Insider source

1
Log into the Zeotap CDP App and navigate to the Sources application under Integrate.
2
Click CREATE SOURCE.
3
Choose Customer Engagement Channels as the category.
CREATE SOURCE dialog listing source categories, with Customer Engagement Channels selected at the bottom of the list.

Step 1 of the CREATE SOURCE dialog — choosing a source category.

4
Click Insider Webhook as the data source.
CREATE SOURCE dialog showing customer engagement channel data sources, with the Insider Webhook option selected.

The Customer Engagement Channels list, with Insider Webhook selected.

5
Enter a Source Name.
6
Select your Region — Europe (EU) or United Kingdom (UK).
7
Select the Data Entity. Customer Engagement Channel sources carry Customer Data.
Source Details step of the CREATE SOURCE dialog, with the Source Name field, the Region options Europe (EU) and United Kingdom (UK), and the Data Entity options Customer Data and Non Customer Data.

Step 2 of the CREATE SOURCE dialog — source name, region and data entity.

8
Click CREATE SOURCE.On successful creation, an API URL and a write key are generated for the source and appear under Access Details on the IMPLEMENTATION DETAILS tab. Use the copy icon beside each field to copy them.Both values are needed to complete the integration in Insider: the API URL is the endpoint the webhook posts to, and the write key is what lets Insider ingest data into this source securely. Store the write key as you would any other credential.
Source detail page for an Insider Webhook source with status Created, showing the IMPLEMENTATION DETAILS, PREVIEW DATA, CATALOGUE MAPPING and SOURCE REPORT tabs and the Access Details panel containing the API URL and write key fields with their copy buttons.

The source detail page of a newly created source, on its IMPLEMENTATION DETAILS tab.

Verify the source was created

The new source opens on its IMPLEMENTATION DETAILS tab, alongside the PREVIEW DATA, CATALOGUE MAPPING and SOURCE REPORT tabs, and carries the status Created. Status tells you how far the source has progressed:
  • Created — the source exists, but has not received any data yet. An Insider source stays at Created until you finish configuring the webhook in Insider and it sends its first event.
  • Integrated — data has started flowing in, but taxonomy standardisation has not been applied yet. You can inspect the incoming data on the source’s PREVIEW DATA tab.
  • Mapped — at least one data collection has been created on top of the integrated source, based on the common taxonomy.
For the full set of statuses and the other columns on the source listing, see Components of the source listing page.

Troubleshoot the source

The source never leaves the Created status. Nothing has reached it yet. Check the webhook in Insider: the endpoint must be the API URL from the IMPLEMENTATION DETAILS tab, the Authorization header must carry the write key from the same tab, and the integration must be launched as Active rather than left as Draft or Paused. Insider’s Test Webhook button reports the response status for a test request. The steps are in Implement an Insider source. An alert icon appears beside the source in the listing. An erroneous record was ingested in the last 90 days. The icon remains until the errors are fixed. Data stops arriving after the source is paused. Pausing data collection invalidates the write key on the source, which stops collection. Resume data collection from the three-dot ACTIONS menu against the source on the source listing. To be notified by email when a source fails, configure Source alerts.

Next steps

  • Implement an Insider source — configure the webhook inside Insider using the API URL and write key from this source, choose the events and attributes to send, and launch the integration.
  • Insider Webhook — overview of the Insider source integration.
  • Insider — the opposite direction: send audiences and events from Zeotap CDP to Insider.
Last modified on September 24, 2026