> ## 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.

# Zeotap Webhook

## Overview

A Webhook is a type of integration that allows you to establish a secure connection between Zeotap and your internal system. It enables Zeotap to conveniently transfer data based on the criteria you specify. Once you enable the Webhook, Zeotap initiates HTTP calls to your designated endpoint. As soon as Zeotap receives data, it promptly forwards it to your HTTP endpoint. This ensures efficient data transfer between Zeotap and your system.

## Integration with Zeotap Webhook

### Prerequisites

Ensure that you have the following details available before starting the integration:

* Upload URL
* API Type
* Authentication Type

#### Upload URL

This is the end point URL of the customer’s API through which Zeotap sends data to the customer.

#### API Type

API Type refers to the specific category of an API based on its functionality. The following are the API types supported by Zeotap:

* **POST** – This API Type allows you to include data that the recipient server uses to create a new resource. For example, in a blog API, you can use the POST API type to create a new blog post by sending the content and other details in the request body.
* **PATCH** – This API Type allows you to update specific fields of an existing resource. Unlike the PUT method that replaces the entire resource, PATCH allows partial updates. For example, in an e-commerce API, you can use a PATCH request to update the quantity or price of a product.

#### Authentication Type

Authentication Type is a method to verify the identity of a customer who is attempting to access the system or resource. The following are the two Authentication Types supported by Zeotap:

* **Basic** - This information is used to verify your identity and grant access to the relevant resource. If you choose Basic as the Authentication Type, then you have to provide a **Username** and **Password**.
  <Frame>
    <img src="https://mintcdn.com/zeotap/1FGgO964H8EKim6t/articles/integrate-customer/Storage/integrate-customer/zeotap-webhook/webhook_1.png?fit=max&auto=format&n=1FGgO964H8EKim6t&q=85&s=05973bdd1789d47f6e2cc142fb81c175" width="952" height="950" data-path="articles/integrate-customer/Storage/integrate-customer/zeotap-webhook/webhook_1.png" />
  </Frame>

* **Static Bearer Token** - This token is generated by your client who host their resource/system in Webhook. If you choose Static Bearer Token as the Authentication Type, you must provide a Bearer Token. This serves as a form of authentication to access the relevant resource.
  <Frame>
    <img src="https://mintcdn.com/zeotap/1FGgO964H8EKim6t/articles/integrate-customer/Storage/integrate-customer/zeotap-webhook/webhook_2.png?fit=max&auto=format&n=1FGgO964H8EKim6t&q=85&s=b43868a1a3d81cf7f771fea39775b511" width="932" height="954" data-path="articles/integrate-customer/Storage/integrate-customer/zeotap-webhook/webhook_2.png" />
  </Frame>

## Destination Setup

After you have applied filters or added conditions for your users in Journeys, you can activate them in Zeotap Webhook under **Send to Destinations.** A new window appears, where you can set up your destination. You can use an already existing destination from the list of available Destinations \*\*\*\* or create a new one by clicking **+ Add New Destination**.

<Frame>
  <img src="https://mintcdn.com/zeotap/uNvkTzntz_KCWwLF/articles/integrate-customer/Storage/integrate-customer/zeotap-webhook/zeotap-webhook-2024-08-07.png?fit=max&auto=format&n=uNvkTzntz_KCWwLF&q=85&s=7f45db542483703d773a6271d8899ddc" width="1858" height="1070" data-path="articles/integrate-customer/Storage/integrate-customer/zeotap-webhook/zeotap-webhook-2024-08-07.png" />
</Frame>

### Add New Destination

Perform the following steps to add a new destination:

<Steps>
  <Step>
    Click **Add New Destination.**
  </Step>

  <Step>
    Search for **Zeotap Webhook.**
  </Step>

  <Step>
    Click **Zeotap Webhook** and enter a name for the Destination.
  </Step>

  <Step>
    Choose the **API Type** from the drop-down menu. You can either choose **POST** or **PATCH** as per your requirement. To know more about these API Types, refer here.
  </Step>

  <Step>
    Choose the **Authentication Type** from the drop-down menu. You can either choose **BASIC** or **STATIC BEARER TOKEN** depending on the requirement. Based on your selection, enter the required user input. To know more about these Authentication Types, refer [here](#authentication-type).

    <Frame>
      <img src="https://mintcdn.com/zeotap/1FGgO964H8EKim6t/articles/integrate-customer/Storage/integrate-customer/zeotap-webhook/zeotap-webhook-2024-08-07-1.png?fit=max&auto=format&n=1FGgO964H8EKim6t&q=85&s=cb0b30bb6cad8cfd97bc5d8304d1b946" width="1042" height="1312" data-path="articles/integrate-customer/Storage/integrate-customer/zeotap-webhook/zeotap-webhook-2024-08-07-1.png" />
    </Frame>
  </Step>

  <Step>
    In the mapping screen that appears, under **Choose your Action**, select **Send identifiers and attributes to Zeotap Webhook** as the action for sending data from the workflow created in Journeys. Under **Map the Fields**, you can map custom data to the relevant Zeotap field and send to Zeotap Webhook.

    <Frame>
      <img src="https://mintcdn.com/zeotap/1FGgO964H8EKim6t/articles/integrate-customer/Storage/integrate-customer/zeotap-webhook/zeotap-webhook-2024-08-07-2.png?fit=max&auto=format&n=1FGgO964H8EKim6t&q=85&s=d10f0a9ed14ea169383393f3b370f523" width="1936" height="1748" data-path="articles/integrate-customer/Storage/integrate-customer/zeotap-webhook/zeotap-webhook-2024-08-07-2.png" />
    </Frame>
  </Step>

  <Step>
    Once the mapping is complete, click **Create Destination**. The destination is created and made available for activation on Journeys.
  </Step>
</Steps>

<Note>
  **Note:**

  Ensure that you map at least one attribute. Otherwise, the data does not flow to the Destination.
</Note>

## Activate the Destination on Journeys

After creating a destination, next, you need to link it in the **Send to Destination** node within the workflow, as explained below.

<Steps>
  <Step>
    In the workflow, click **+** and choose **Send to Destinations**.

    <Frame>
      <img src="https://mintcdn.com/zeotap/1FGgO964H8EKim6t/articles/integrate-customer/Storage/integrate-customer/zeotap-webhook/zeotap-webhook-2024-08-07-3.png?fit=max&auto=format&n=1FGgO964H8EKim6t&q=85&s=4caa9c36047d1bd3b3c623919229f669" width="1032" height="542" data-path="articles/integrate-customer/Storage/integrate-customer/zeotap-webhook/zeotap-webhook-2024-08-07-3.png" />
    </Frame>
  </Step>

  <Step>
    Choose the destination from the list of available destinations by using the search feature.

    <Frame>
      <img src="https://mintcdn.com/zeotap/1FGgO964H8EKim6t/articles/integrate-customer/Storage/integrate-customer/zeotap-webhook/zeotap-webhook-2024-08-07-4.png?fit=max&auto=format&n=1FGgO964H8EKim6t&q=85&s=cdf9391717d69a54585d4f69399a3a67" width="1896" height="1056" data-path="articles/integrate-customer/Storage/integrate-customer/zeotap-webhook/zeotap-webhook-2024-08-07-4.png" />
    </Frame>
  </Step>

  <Step>
    Under the **Destination Details** tab, the **Upload URL, API Type, Authentication Type** and **Bearer Token** fields are automatically populated based on the value that you had entered while creating the destination. However, in the **Audience** field, enter a name to categorise your users.

    <Frame>
      <img src="https://mintcdn.com/zeotap/uNvkTzntz_KCWwLF/articles/integrate-customer/Storage/integrate-customer/zeotap-webhook/zeotap-webhook-2024-08-07-5.png?fit=max&auto=format&n=uNvkTzntz_KCWwLF&q=85&s=6b730131536277e56ed7b8a98cbcddd9" width="1874" height="1632" data-path="articles/integrate-customer/Storage/integrate-customer/zeotap-webhook/zeotap-webhook-2024-08-07-5.png" />
    </Frame>
  </Step>

  <Step>
    Under the **Destination Settings** tab, choose the Action and mapping as per your requirement.

    <Frame>
      <img src="https://mintcdn.com/zeotap/uNvkTzntz_KCWwLF/articles/integrate-customer/Storage/integrate-customer/zeotap-webhook/zeotap-webhook-2024-08-07-6.png?fit=max&auto=format&n=uNvkTzntz_KCWwLF&q=85&s=873866ef7694926d7570c15a14fc8b47" width="1922" height="1272" data-path="articles/integrate-customer/Storage/integrate-customer/zeotap-webhook/zeotap-webhook-2024-08-07-6.png" />
    </Frame>
  </Step>

  <Step>
    Upon clicking **Save Destination**. The destination is attached as shown in the image below.

    <Frame>
      <img src="https://mintcdn.com/zeotap/uNvkTzntz_KCWwLF/articles/integrate-customer/Storage/integrate-customer/zeotap-webhook/zeotap-webhook-2024-08-07-7.png?fit=max&auto=format&n=uNvkTzntz_KCWwLF&q=85&s=6838fd5fef1b13002f2802f68d74dc92" width="1892" height="1104" data-path="articles/integrate-customer/Storage/integrate-customer/zeotap-webhook/zeotap-webhook-2024-08-07-7.png" />
    </Frame>
  </Step>
</Steps>
