Webhooks & Event Tracking

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