# Set up Batch Webhook Integration

Single Webhooks are sent when an event for which response data has been requested is completed. As a result, data is sent at intervals. Therefore, these webhooks are ideal for realtime campaigns.

Batch Webhooks, on the other hand, are suitable if you expect a large amount of data to come at once.

Before you begin, you should have the following information available:

* The destination URL, method and content type
* The username and password to be used when sending the webhook (if the destination URL requires authentication)
* The authentication header (or other special headers if they are used for authentication)

## **Setting up a Batch 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>

* 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
* Header Authentication
* URL based authentication.

Please note that OAuth authentication is not currently supported. For more information regarding supported authentication, please reach out to your dedicated Customer Success manager or send an email to <support@crossengage.io>.

### Content type

Choose the content type application/JSON.

### Message Batching

Turn on Message Batching, and choose a batch size from 50 to 1000.

### Append HTTP headers

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

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


---

# 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/batch-webhook/set-up-batch-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.