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


---

# 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://docs.bizmagnets.ai/api-documents/webhook.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.