From e44c8dacfeda64539a72b1663e5a63e0619974a7 Mon Sep 17 00:00:00 2001
From: Parth Panchal <83201188+parthp2107@users.noreply.github.com>
Date: Mon, 5 Sep 2022 19:54:26 +0530
Subject: [PATCH] added webhook types doc (#7229)

---
 .../content/developers/webhooks.md            | 53 ++++++++++++++++++-
 1 file changed, 52 insertions(+), 1 deletion(-)

diff --git a/openmetadata-docs/content/developers/webhooks.md b/openmetadata-docs/content/developers/webhooks.md
index e1ac40f0f6b..4d278569a7e 100644
--- a/openmetadata-docs/content/developers/webhooks.md
+++ b/openmetadata-docs/content/developers/webhooks.md
@@ -3,4 +3,55 @@ title: Webhooks
 slug: /developers/webhooks
 ---
 
-# Webhooks
\ No newline at end of file
+# Webhooks
+
+A webhook is a way for an app to provide other applications with real-time information.
+A webhook delivers data to other applications as it happens, meaning you get data immediately.
+OpenMetadata out of the box provide support for Webhooks.
+Webhooks can be used to get real-time information for the application when an event occurs.
+OpenMetadata also allows the user to customise the webhook with a wide range of filters to listen to only selected type of events
+
+
+## OpenMetadata supports 3 webhook types:
+1. **Generic**
+2. **Slack**
+3. **Microsoft Teams**
+
+## How to Set up Generic Type Webhook:
+1. **Name**: Add the name of the webhook
+2. **Description**: Add description of the webhook/Describe the webhook.
+3. **Endpoint URL**: Enter the Consumer/client URL to consume the event's data.
+4. **Activity Filter**: Can be used to activate or disable the webhook.
+5. **Event Filters**: Filters are provided for all the entities and for all the events.
+   Event data for specific action can be achieved.
+6. **Batch Size**: Enter the batch size.
+7. **Connection Timeout**: Enter the desired connection timeout.
+8. **Secret Key**: Secret key can be used to secure the webhook connection.
+
+![webhook-generic](https://user-images.githubusercontent.com/83201188/188461969-7f318869-4048-4625-a896-da88bce811c2.png)
+
+## How to Set up Slack Type Webhook:
+1. **Name**: Add the name of the webhook
+2. **Description**: Add description of the webhook/Describe the webhook.
+3. **Endpoint URL**: Enter the Slack endpoint url.
+4. **Activity Filter**: Can be used to activate or disable the webhook.
+5. **Event Filters**: Filters are provided for all the entities and for all the events.
+   Event data for specific action can be achieved.
+6. **Batch Size**: Enter the batch size.
+7. **Connection Timeout**: Enter the desired connection timeout.
+8. **Secret Key**: Secret key can be used to secure the webhook connection.
+
+![webhook-slack](https://user-images.githubusercontent.com/83201188/188462920-2028f777-af0e-4868-b4d2-01e45f520a25.png)
+
+## How to Set up Microsoft Teams Type Webhook:
+1. **Name**: Add the name of the webhook
+2. **Description**: Add description of the webhook/Describe the webhook.
+3. **Endpoint URL**: Enter the MS Teams endpoint url.
+4. **Activity Filter**: Can be used to activate or disable the webhook.
+5. **Event Filters**: Filters are provided for all the entities and for all the events.
+   Event data for specific action can be achieved.
+6. **Batch Size**: Enter the batch size.
+7. **Connection Timeout**: Enter the desired connection timeout.
+8. **Secret Key**: Secret key can be used to secure the webhook connection.
+
+![webhook-msteams](https://user-images.githubusercontent.com/83201188/188462667-bd8443ce-a07d-4742-ae5d-42da3fc2d402.png)  
\ No newline at end of file