---
title: "Webhooks & Event Tracking"
url: "https://knowledge-base.discovered.ai/en/article/webhooks-event-tracking"
language: "en"
last_updated: "2026-10-30T22:38:05.413Z"
---

# Webhooks & Event Tracking

Automatically send real-time data from Discovered to other platforms using webhooks.

### **Overview**

**Webhooks** in Discovered allow you to automatically transmit event-based data to external systems as soon as key actions occur within your account. With webhooks, you can connect Discovered to third-party tools or internal databases, enabling seamless automation and integration with your existing workflows.

For example, when a **candidate is added to a job** or **a candidate is hired**, Discovered can immediately send this event data to your desired endpoint—such as a CRM, HRIS, or analytics tool—without any manual intervention.

This feature is ideal for clients who want to track critical recruiting events across multiple platforms, automate reporting, or trigger follow-up actions in other systems.

**1\. Request Webhook Setup**

-   Contact **Discovered Support** at [support@discoveredats.com](mailto:support@discoveredats.com) (or through your account representative).
-   Specify the **event(s)** you’d like to track and provide the **destination URL** where webhook data should be posted.

Example request:

> “Please set up a webhook for our account to trigger whenever a new candidate is hired. Send the webhook data to: https://examplecompany.com/webhook-endpoint.”

**2\. Supported Event Types:**

-   Discovered can send a webhook for any of the events below, and one webhook can listen to several of them. When you contact Support, tell us which events you want.
-   -   **Candidate added to a job**
    -   -   Added manually
        -   Added by email
        -   Applied through an application form
        -   Applied through a job board
        -   Added through an assessment link
        -   Copied to or from another job
        -   Moved from another job
    -   **Pipeline**
    -   -   Moved to a status
        -   Hired
        -   Added to or removed from favorites
        -   Given a star rating
    -   **Applications and screening**
    -   -   Application requested
        -   Application completed
        -   Screening questions answered
        -   Resume updated
        -   Document added
    -   **Interviews**
    -   -   Interview questions sent
        -   One-way interview completed
        -   Interview scheduling requested
        -   Interview scheduled
        -   Interview changed
    -   **Assessments**
    -   -   Assigned manually
        -   Assigned through an assessment link
        -   Assigned automatically by a status
        -   Completed
    -   **References**
    -   -   References requested manually
        -   References requested automatically by a status
        -   Reference questions sent
        -   Reference requests stopped
        -   Candidate submitted reference contacts
        -   Reference completed
        -   Reference declined
    -   **Communication and notes**
    -   -   Email sent to candidate
        -   Text sent to candidate
        -   Note added, edited or deleted

**3\. How Webhooks Work:**

-   Once a webhook is set up for your company:
-   -   Discovered stores your **webhook URL** and **event trigger** in a secure database.
    -   When the specified event occurs (e.g., a candidate is hired), Discovered automatically sends a **POST request** to your designated webhook URL.
    -   The payload includes the event type, a unique event ID, the candidate's name, email, phone and resume link, the job's title and location, the candidate's source, and the time the event fired. Where an event relates to a specific record, such as a note, message, reference or meeting, that record's details are included too.

**4\. Receiving and Using Webhook Data:**

-   Once configured, your system can capture and process the webhook data to trigger automated actions, such as:
-   -   Adding candidate data to your **CRM or HR system**.
    -   Updating dashboards or analytics reports.
    -   Sending internal notifications to hiring managers.
    -   Logging hiring events for compliance or performance tracking.
-   If you’re using automation platforms like **Zapier**, you [can configure them to listen for Discovered webhook events](https://knowledge-base.discovered.ai/en/article/automating-new-hire-information-to-payroll-using-webhooks-and-zapier) and pass data to thousands of supported apps.

**5\. Testing and Verification:**

-   After setup:
-   -   Discovered will trigger a **test webhook** to your provided URL to confirm it’s working correctly.
    -   Your technical team can verify receipt of the payload and ensure your system processes it as expected.
    -   Once verified, live webhooks will automatically activate for your chosen events.

## **Why This Matters**

Webhooks empower your team to integrate Discovered with your broader HR or business ecosystem. With event-based automation, you can:

-   Eliminate manual data entry and synchronization.
-   Maintain accurate, real-time records across systems.
-   Automate follow-up workflows based on hiring milestones.
-   Gain deeper visibility into recruiting performance and outcomes.

This ensures seamless communication between Discovered and your preferred platforms—saving time and reducing administrative workload.

## **Use Cases**

-   **Recruiting Analytics:** Automatically log candidate hires into a BI or reporting tool.
-   **CRM Integration:** Sync new candidates to your CRM for future engagement.
-   **Internal Notifications:** Alert team members in Slack or Teams when candidates are added or hired.
-   **HR System Sync:** Automatically add hired candidates to your HR or payroll software.

## **Best Practices**

-   Always **verify your webhook endpoint** is secure (HTTPS) before providing it to Discovered.
-   Test webhook payloads with a tool like **Webhook.site** or **Postman** before final activation.
-   Use descriptive endpoint names (e.g., `/candidate-hired`) to easily identify incoming data.
-   Document internal webhook handling procedures for future updates or troubleshooting.
-   Notify Discovered Support immediately if your webhook URL changes, to prevent delivery failures.

## **What Happens Next**

Once your webhook request is approved and configured:

-   The webhook will become active for the specified event(s).
-   Event data will automatically post to your configured endpoint whenever triggers occur.
-   You can modify or deactivate a webhook by contacting **Discovered Support**.
-   Additional event triggers can be added later upon request.

With **Client Webhooks & Event Tracking**, you can create powerful, real-time integrations between Discovered and your existing tools—keeping your data in sync and your recruiting process fully automated.