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:
- Currently, Discovered supports webhooks for the following two events:
- Candidate Added to a Job – triggers when a new candidate is added to any job within your account.
- Candidate Hired – triggers when a candidate’s status is updated to “Hired.”
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 contains relevant event data, such as candidate details, job information, and timestamps.
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.