> For the complete documentation index, see [llms.txt](https://docs.bizmagnets.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bizmagnets.ai/api-documents/webhook.md).

# Webhook

Simply set up your target URL, authenticate with a secure token, and select the events you want to monitor—BizMagnets will handle the rest.

Effortlessly connect your systems by configuring:

* **Request URL** – Your designated endpoint to receive real-time data and event notifications from BizMagnets.
* **Secret Token** – Secure authentication to verify incoming webhook requests.
* **HTTP Headers** – Custom headers for additional security and metadata.
* **Event Selection** – Choose specific triggers to automate workflows.

## **Create a New Webhook Integration**

1. Navigate to **'Integration'** section from the left navigation panel and select **'Webhook'** from the menu options.

<figure><img src="/files/6xWRUfnKEFNmtm3lF6RN" alt=""><figcaption></figcaption></figure>

2. Click the **'+ Add'** button. This will open the webhook configuration interface.

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

{% hint style="info" %}
Ensure you have your receiving endpoint URL ready before starting the setup process for seamless integration.
{% endhint %}

3. Enter your **Request URL** where BizMagnets should deliver webhook notifications.
4. Enter the **Secret** to verify incoming webhook requests.
5. Choose from a variety of **Events** for which notifications will be triggered.

### Webhook Events <a href="#webhook-events" id="webhook-events"></a>

Users can select from the following categories of events:

**Contact**

<table><thead><tr><th width="248">Event</th><th>Descrition</th></tr></thead><tbody><tr><td>Contact created</td><td>Triggered when a new contact is created.</td></tr><tr><td>Contact updated</td><td>Triggered when an existing contact is updated.</td></tr></tbody></table>

**Ticket**&#x20;

<table><thead><tr><th width="248">Event</th><th>Descrition</th></tr></thead><tbody><tr><td>Ticket created</td><td>Triggered when a new ticket is created.</td></tr><tr><td>Ticket updated</td><td>Triggered when an existing ticket is updated.</td></tr></tbody></table>

**Conversation**

<table><thead><tr><th width="248">Event</th><th>Descrition</th></tr></thead><tbody><tr><td>Conversation  created</td><td>Triggered when a new conversation is created.</td></tr><tr><td>Conversation updated</td><td>Triggered when an existing conversation is updated.</td></tr><tr><td>Message received</td><td>Triggered when a new message is received.</td></tr></tbody></table>

6. Configure additional HTTP **Headers** if required by your receiving system.

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

7. Click 'Create Webhook' after entering all the necessary details.

## **Webhook Logs**&#x20;

BizMagnets webhook logs provide comprehensive tracking and monitoring of all webhook activities, giving you complete visibility into event triggers and delivery statuses.

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

### **Log Details Breakdown**

**Log ID:** Unique identifier for each webhook entry, enabling easy tracking and auditing.

**Event:** Specifies the triggered event type (e.g., Payment Processed, Support Ticket Created).

**Timestamp:** Date and time when the event occurred, ensuring chronological tracking.

**Status:** Indicates delivery success or failure (e.g., Success, Failed, Pending).&#x20;

**Payload:** Contains all transmitted data, including customer details, transaction info, and event metadata.