# Set up Webhook Integration

A webhook delivers data to other applications in real-time. Unlike typical APIs where frequent calls must be made to obtain real-time data, webhooks can be triggered automatically, for example in response to user events.

Before you begin, you should have the following information on hand:

* The destination URL, method and content type you would like to use
* If the destination URL requires authentification, please ensure you have the username and password that should be used when sending the webhook
* If you use a header for authentication or require other special headers, please also have these on hand

### Setting up a Webhook Integration

* In the CrossEngage app, navigate to `Settings` > `Integrations`.
* Click the `Add new integration` button in the top right corner of the page.

<figure><img src="/files/zfWLFaM1kVBGbSAJoguR" alt=""><figcaption></figcaption></figure>

* &#x20;Search for 'webhook'  and click **Set up.**

<figure><img src="/files/ZjBx8T9HDE9twkpBjekW" alt=""><figcaption></figcaption></figure>

Using this information, you can now complete the setup form.

## Sender Info

The sender information is the method (POST or PUT) and Destination URL that will be used to dispatch the webhook.

## Authentication

You are able to use three types of authentication when using Webhooks on CrossEngage:

* Basic Authentication
* WSSE Authentication
* OAuth 2 authentication.&#x20;

### Append HTTP headers

If you require any special headers or authentication headers, please add the key - value pairs here.

### Content type

At this stage, you are able to choose what type of content the webhook will send to your destination URL. We currently support Javascript, JSON, XML and URL-encoded content types.

### Default Message Content

Since the structure of a webhook will not considerably change over the time, you can prefill the default message at this stage.

The information entered here will appear by default in every new message created on CrossEngage.

### Additional Properties

You can define additional properties that will be added to events.

<figure><img src="/files/MsGZSWWGmmBERgUAOscz" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.crossengage.io/data-and-engagement-platform/messages/integrations/channels/webhooks/single-webhook/set-up-webhook-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.