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

# Webhook

### **Overview**

Webhooks in DeepAgent allow you to send real-time data to external applications when specific events occur. By setting up a webhook, you can automate workflows, trigger actions in third-party tools, and enhance customer interactions.

This guide provides step-by-step instructions for integrating a webhook in DeepAgent.

### **Step-by-Step Instructions**

#### **Step 1: Access Webhook Integration**

1. **Log in** to your **GoZen DeepAgent** account.
2. In the **DeepAgent** dashboard, navigate to the left menu.
3. Click on **Integration.**

<figure><img src="/files/1HPiaxkktrmmrYonKUCp" alt=""><figcaption></figcaption></figure>

4. Select **Webhook** from the available integration options.

#### **Step 2: Configure Webhook Details**

1. In the **Webhook** setup page, enter the **Webhook URL** where DeepAgent will send the data.

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

* Ensure that the URL is **publicly accessible** and supports incoming requests.

2. Under **Headers**, add any required authentication or security parameters:

* **Key:** Example - `Password`.
* **Value:** Corresponding authentication value.

#### **Step 3: Connect the Webhook**

1. Click on the **"Connect"** button.

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

2. DeepAgent will validate the webhook URL. If successful, your webhook is now active.

#### **Step 4: Test the Webhook**

<figure><img src="/files/1fhXjzQOGfLGt2SZaUho" alt=""><figcaption></figcaption></figure>

1. Once the webhook is connected, test it by triggering an event in DeepAgent (e.g., a new message or lead capture).
2. Check your external application to ensure that it receives the data correctly.

#### **Step 5:** If issues occur, verify that:

* The webhook URL is correct.
* Authentication details are valid.
* The external system is correctly handling incoming requests.

### **Additional Notes**

* Use **HTTPS** URLs to ensure secure data transmission.
* If your external system requires authentication, configure the appropriate headers.
* Make sure your server can handle incoming **POST** requests from DeepAgent.

By integrating a webhook, you can automate data transfer between DeepAgent and your external platforms, enhancing workflow efficiency and real-time responsiveness.

###