Send candidate events to your own systems automatically
Webhooks push real-time notifications to your servers when candidates complete exams, apply for jobs, or move through your pipeline. Use webhooks to sync data with your ATS, trigger Slack alerts, or automate custom workflows.
TalentScreen fires events like exam.completed, application.submitted, candidate.moved, and interview.scheduled. Each event includes full candidate data, exam scores, and timestamps. Payloads follow a consistent JSON schema.
Prepare Your Endpoint
Set up a public HTTPS URL that accepts POST requests. Your server must respond with 2xx status within 5 seconds. Test with tools like webhook.site before configuring.
Create Webhook in TalentScreen
Go to Settings > Integrations > Webhooks. Click 'Add Webhook'. Paste your endpoint URL and choose which events to subscribe to.
Add Security Signature
Enable webhook signing to verify requests come from TalentScreen. We sign payloads with HMAC-SHA256. Your secret key appears once, so save it securely.
Test the Integration
Use 'Send Test Event' to fire a sample payload. Check your server logs to confirm receipt. Verify signature validation works correctly.
Handle Retries Gracefully
If your endpoint fails, we retry up to 3 times with exponential backoff. Ensure your handler is idempotent (can safely process the same event twice).
Never expose webhook URLs publicly without signature verification. Attackers could spam fake events or probe your endpoints.
View webhook delivery logs in Settings > Integrations. Inspect request/response pairs for failed deliveries. Use replay feature to resend events during debugging.
Was this article helpful?