> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeotap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Insider

## Overview

Insider is a customer experience (CX) platform that enables businesses to deliver personalised and data-driven interactions across multiple channels. The platform helps companies analyse customer behaviour, segment audiences, and automate marketing efforts to enhance engagement and conversions.

By integrating Zeotap CDP with Insider, you can:

* Share audience data from Zeotap CDP to Insider for activation and targeting.
* Forward events from Zeotap CDP to Insider.
* Trigger automation using custom events sent from Zeotap CDP Journeys to Insider.
* Send event properties and user attributes from workflows created in Zeotap CDP to Insider.

## Supported Identifiers

You can use this integration to send any identifiers such as Email, Phone number (E.164 format), UUID, Custom identifiers and other attributes of your choice.

## Prerequisites

Ensure to obtain the following prerequisites from your InOne (Insider) account before creating an Insider destination in Zeotap CDP:

* API key
* Partner name

## Authentication

Insider uses Basic Authentication, which requires a *username* and an *API key*. After setting up your InOne (Insider) account, generate a Unified Customer Database (UCD) API key to push data using the Insider Upsert API.

### Generate an API Key

Perform the following steps to generate an API Key:

<Steps>
  <Step>
    Log in to InOne.
  </Step>

  <Step>
    Navigate to **Username** > **Settings** > **InOne Settings** > **Integration Settings** as shown below.

    <Frame>
      <img src="https://mintcdn.com/zeotap/99ae7Xt83Dkoy1LQ/articles/integrate-customer/Storage/integrate-customer/insider/insider-2025-03-04-6.png?fit=max&auto=format&n=99ae7Xt83Dkoy1LQ&q=85&s=0c501dc0962c28a42fee800ab68959ec" width="2728" height="548" data-path="articles/integrate-customer/Storage/integrate-customer/insider/insider-2025-03-04-6.png" />
    </Frame>
  </Step>

  <Step>
    Scroll to the **API Keys** section and click **Generate API Key.**

    If you have existing API keys, they appear in this section.

    <Frame>
      <img src="https://mintcdn.com/zeotap/99ae7Xt83Dkoy1LQ/articles/integrate-customer/Storage/integrate-customer/insider/insider-2025-03-04-1.png?fit=max&auto=format&n=99ae7Xt83Dkoy1LQ&q=85&s=2ae90a02fc39743b96fcfd023dc02a06" width="2574" height="170" data-path="articles/integrate-customer/Storage/integrate-customer/insider/insider-2025-03-04-1.png" />
    </Frame>
  </Step>

  <Step>
    Select the API type to generate the key and click **Next** to create the key.

    <Frame>
      <img src="https://mintcdn.com/zeotap/99ae7Xt83Dkoy1LQ/articles/integrate-customer/Storage/integrate-customer/insider/insider-2025-03-04-2.png?fit=max&auto=format&n=99ae7Xt83Dkoy1LQ&q=85&s=991ab94df92c7d59b7b4d6ed4487d67a" width="990" height="1266" data-path="articles/integrate-customer/Storage/integrate-customer/insider/insider-2025-03-04-2.png" />
    </Frame>
  </Step>

  <Step>
    Click **Copy** to save the key before closing the prompt. **You cannot access the key after closing the window, so copy and store it securely.**

    <Frame>
      <img src="https://mintcdn.com/zeotap/99ae7Xt83Dkoy1LQ/articles/integrate-customer/Storage/integrate-customer/insider/insider-2025-03-04-3.png?fit=max&auto=format&n=99ae7Xt83Dkoy1LQ&q=85&s=25a23df40428e022559cd313b33c7685" width="1008" height="792" data-path="articles/integrate-customer/Storage/integrate-customer/insider/insider-2025-03-04-3.png" />
    </Frame>
  </Step>
</Steps>

### Delete an API Key

To delete an existing API key, click **Delete** next to the key.

## Create a Destination for Insider

Follow these steps to create a destination for Insider:

<Steps>
  <Step>
    Log into the Zeotap CDP App and go to the **DESTINATIONS** application.
  </Step>

  <Step>
    Click **+ Create Destination**.
  </Step>

  <Step>
    Under **All Destinations**, search for **Insider**.
  </Step>

  <Step>
    Click **Insider**. A screen appears displaying details about the destination on the left and required integration fields on the right. Enter the following details:

    * **Destination name**: Enter a name for the destination.
    * **Destination Instance Nam**e: Provide a desired value for this internal field.
    * **API Key**: Enter the API key generated in Insider.
    * **Partner Name**: Enter your Insider partner name obtained from your Insider account.

    <Frame>
      <img src="https://mintcdn.com/zeotap/99ae7Xt83Dkoy1LQ/articles/integrate-customer/Storage/integrate-customer/insider/insider-2025-03-04-4.png?fit=max&auto=format&n=99ae7Xt83Dkoy1LQ&q=85&s=24b5a358fd09f3fd961e9edbe88a7469" width="3554" height="1736" data-path="articles/integrate-customer/Storage/integrate-customer/insider/insider-2025-03-04-4.png" />
    </Frame>
  </Step>

  <Step>
    Click **Next** to proceed to mapping.
  </Step>
</Steps>

## Actions and Mapping

On the **Actions and Mapping** screen, choose the action depending on whether you want to use **Audiences (batched data activation)** or **Journeys (real-time activation)**, depending on your use case.

### Audiences (Batched Data)

Supported Action: **Send Attributes and Identifiers**

#### Mapping

Under **Map the Fields**, map Catalogue fields and Destination fields for audience attributes and identifiers.

Required fields:

* **User Identifiers**: Email, Phone number, UUID
* **User Attributes**: Name, Age, Gender, Language, City, Country, Custom attributes

### Journeys (Real-Time Activation)

Supported Actions:

* Add to Cart Event
* Cart Page View Event
* Custom Event
* Item Removed from Cart Event
* Purchase Event
* Send Homepage View Event
* Send Listing View Event
* Send Product Detail Page View Event

#### Mapping

Under **Map the Fields**, for each Journey action, the system populates a list of identifiers and attributes. Ensure to map Catalogue fields and Destination fields appropriately.

Required fields:

* You must mandatorily map the **Event Name** and **Timestamp** fields for all events.
* Map additional event parameters based on the event type you wish to target.

<Frame>
  <img src="https://mintcdn.com/zeotap/99ae7Xt83Dkoy1LQ/articles/integrate-customer/Storage/integrate-customer/insider/insider-2025-03-04-5.png?fit=max&auto=format&n=99ae7Xt83Dkoy1LQ&q=85&s=9b78d44613cab75e5419e9d177e35035" width="2426" height="338" data-path="articles/integrate-customer/Storage/integrate-customer/insider/insider-2025-03-04-5.png" />
</Frame>
