# Zapier -> Lark

How the connection HackenProof -> Zapier Webhook works

This guide explains how our[ Zapier](https://zapier.com/) WebHook can help companies with notifications when they run a bounty program at HackenProof.

Please note! It's Zapier Webhook integration, not Zappier App

As you know, HackenProof uses a ticket-based system that has[ different stages of reports](https://docs.hackenproof.com/bug-bounty/reports-basics) processing.

Once you connect your bug bounty program to your[ Zapier account](https://zapier.com/), the Zapier will send notifications about the new reports (that include the Program name, Report title, Report severity, Report URL etc.)

### Step 1. Generate your Zapier Webhook URL

* Navigate to your Zapier dashboard.
* Create a new Zap.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc8Llo4yLoMOtNhOg3VIhH-VHeeu5yvzYuAw3i9tmUhcmWvjqbjhwbUA7FcYlhJrSgf0sfsc3DILCeJnCJcYySDeNIr0oIEckKsbZz_FI8G-qetcCVNsqek3zqcBf3ySkfgJBzqYA?key=nxutiEjhzoMI2wTTHJ1d_z6l" alt=""><figcaption></figcaption></figure>

* Choose Trigger: Webhooks by Zapier.

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2F9acqGCm3MrMBWnWjToA5%2Fimage.png?alt=media&#x26;token=efdfd876-4c94-4bb1-82af-a08b42d96005" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2Fj83djiynGfjACNkjN30I%2Fimage.png?alt=media&#x26;token=02573125-20c4-45d0-8ab3-6ecdb782794b" alt=""><figcaption></figcaption></figure>

* Choose the Event type: **Catch Hook.**

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2FbQNDd1ntYsrxhQydoiet%2Fimage.png?alt=media&#x26;token=5b835aaf-066b-4ce0-9213-0198e6e2710d" alt=""><figcaption></figcaption></figure>

* Click the '**Continue'** button.

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2FvQ5e5QVYzDI70yp4TpsD%2Fimage.png?alt=media&#x26;token=3c4bb390-e814-4544-8a7e-e230814ec385" alt=""><figcaption></figcaption></figure>

* Pick off a Child Key and press the '**Continue'** button. **You can name Child Key as you wish.**

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2FxMY8RMAENMHgiTygsZVv%2Fimage.png?alt=media&#x26;token=a9461d0e-35d3-4863-94a4-63349b3440ab" alt=""><figcaption></figcaption></figure>

* Copy the Zapier Webhook URL.

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2FAX7DQlLHnJE5W1pcWcoZ%2Fimage.png?alt=media&#x26;token=e1c543dd-deb8-4504-850e-2aed98c84f07" alt=""><figcaption></figcaption></figure>

### Step 2. Add the copied Zapier Webhook URL to HackenProof <a href="#h_54d1d86b75" id="h_54d1d86b75"></a>

* Navigate to your Program Integrations section and choose Zapier.

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2FSWRXHVzH9evURoFrqsu4%2Fimage.png?alt=media&#x26;token=f3a68f63-e402-470b-baa0-8c524e2469a4" alt=""><figcaption></figcaption></figure>

* Paste your copied Zapier Webhook URL and **press the Connect button.**

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2FgloFUdDwGyO3DCBl6RtN%2Fimage.png?alt=media&#x26;token=03983eca-dd6c-486a-b5e1-0b1c55dd8259" alt=""><figcaption></figcaption></figure>

* Press the **Test WebHook** button to test the connection (it will send the latest report data to Zapier).

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2FbHIOllS8kx8frp3DFG40%2Fimage.png?alt=media&#x26;token=86a98cc5-6044-40b5-80eb-c15d6975dc94" alt=""><figcaption></figcaption></figure>

* Back to your Zapier and click the '**Test Trigger'** button.

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2FxqFfxlq6XFWUuJSjpmGP%2Fimage.png?alt=media&#x26;token=39ce739d-8eb6-4387-823c-5126b84942fd" alt=""><figcaption></figcaption></figure>

* As a result, you will see a data record. Click the '**Continue with the selected record'** butto&#x6E;**.**

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2FkARZNLE5doq3IdxjInsS%2Fimage.png?alt=media&#x26;token=305cca75-8d37-4f02-ac71-d1101d6707bf" alt=""><figcaption></figcaption></figure>

### Step 3. Connect your Lark Suite <a href="#h_3f51fe2960" id="h_3f51fe2960"></a>

* In this guide, we are going to use [Lark Suite](https://www.larksuite.com/). Before starting working with Lark, you need to connect your Lark account in the Zapier App: Navigate to your Zapier Account and make sure you have the necessary connected app.

<div align="center"><figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2F3qYIqq1hTBkVkbRWykFU%2Fimage.png?alt=media&#x26;token=e3c901d9-be0b-4e3c-a601-5088c74e53cd" alt=""><figcaption></figcaption></figure></div>

* Now navigate to your ZAP to continue creating it: choose Action.

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2FeN1lmIZqHR3Rjdkm2X8K%2Fimage.png?alt=media&#x26;token=0767a7a4-23c5-45f8-8aef-b64c08cae085" alt=""><figcaption></figcaption></figure>

* Find and add Lark.

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2FAj1uMzrClxWw43JaFaDO%2Fimage.png?alt=media&#x26;token=bdb0c817-e96e-450c-b194-290b1434e04d" alt=""><figcaption></figcaption></figure>

* Chose the event type **Create New Lark Task (or other event).**<br>

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2FZh5TSdlajt22PTuCTur7%2Fimage.png?alt=media&#x26;token=d77ede5d-fac4-4f90-8fe1-866e59cacd84" alt=""><figcaption></figcaption></figure>

* Click the **'Continue'** button.

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2FZuMTWRvYnjnhB41vV5Q6%2Fimage.png?alt=media&#x26;token=32160657-3056-46df-bc83-4fad542ba0cb" alt=""><figcaption></figcaption></figure>

* **Action**. Now specify, please, data about your Lark project (the data in the screenshot is just an example). &#x20;

  * In the Summary and Description fields, you can add pre-description as shown on the screenshot:

    * Report Title
    * Program name:
    * Report ID:
    * Report URL:
    * Report Severity:
    * Report Status:
    * Report Target Type

    <figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2F7sNqiKfybpPFa7HEmj9a%2Fimage.png?alt=media&#x26;token=e4f65b31-bbaa-4ebf-adff-1c1dda03cb4d" alt=""><figcaption></figcaption></figure>

* Specify data in other required and optional fields, and click the '**Continue'** button.&#x20;

* Now you can Test the Zap.<br>

  <figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2FRjTfNPJbdEqGdZRDlDqE%2Fimage.png?alt=media&#x26;token=d2052344-ab22-450c-bb4b-d7679e240ba1" alt=""><figcaption></figcaption></figure>

* If everything works for you, Publish the ZAP.

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2FfPkfSodKawUQ0hYKVvs5%2Fimage.png?alt=media&#x26;token=f7f8d96c-58ca-4f82-ac81-76711851125d" alt=""><figcaption></figcaption></figure>

* Check your Lark project.

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2FiYGTpZXHNxjzV627FUI3%2Fimage.png?alt=media&#x26;token=6253d0ca-fea6-4bee-89b9-3122d5ba3e17" alt=""><figcaption></figcaption></figure>

* If you open any issue ticket you can see the requested data.&#x20;

<figure><img src="https://2686245090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faou7mxABOvrk0uZ81vUx%2Fuploads%2FaCpS4fOa1IMMWbOUhsQt%2Fimage.png?alt=media&#x26;token=61bf3e41-9cc1-473f-af38-ae235fbb80e5" alt=""><figcaption></figcaption></figure>
