Webhooks
Webhooks allow you to receive real-time notifications when events occur in your Popp account.
Overview
When certain events happen (e.g., a conversation is completed, a meeting is scheduled), Popp sends an HTTP POST request to your specified endpoint with details about the event.
Getting Started
Manage your webhooks from the Developer Portal. You can self-serve the entire webhook lifecycle — creating endpoints, picking which events fire them, sending test deliveries, rotating the signing secret, and deleting webhooks — without needing to contact support.
See the Webhook Management guide for a step-by-step walkthrough.
Event Categories
We support webhooks across these categories:
Conversation Events
Track the lifecycle of candidate conversations.
| Event | Description |
|---|---|
CONVERSATION_QUEUED | Conversation is queued and waiting to start |
CONVERSATION_STARTED | Conversation has started with the candidate |
CONVERSATION_COMPLETED | Conversation completed successfully |
CONVERSATION_NEEDS_REVIEW | Conversation requires manual review |
CONVERSATION_OPTED_OUT | Candidate opted out of the conversation |
START_CONVERSATION_FAILED | Failed to start the conversation |
Analysis Events
Get notified when candidate analysis is complete, when a workflow analysis re-scores an application, and when a workflow analysis can't score one.
| Event | Description |
|---|---|
ANALYSIS_CREATED | A new analysis batch has been created |
CANDIDATE_ANALYSIS_COMPLETED | Analysis for a candidate is complete |
CANDIDATE_ANALYSIS_RESCORED | A workflow analysis re-scored an application before the workflow acted on its score (coming soon) |
CANDIDATE_ANALYSIS_RESCORED_AFTER_ACTED_ON | A workflow analysis re-scored an application after the workflow acted on its score (coming soon) |
CANDIDATE_ANALYSIS_FAILED | A workflow analysis could not score an application (coming soon) |
Scheduling Events
Track calendar and meeting activities.
| Event | Description |
|---|---|
CALENDAR_MEETING_SCHEDULED | A meeting has been scheduled |
CALENDAR_MEETING_CANCELLED | A meeting has been cancelled |
CALENDAR_MEETING_RESCHEDULED | A meeting has been rescheduled |
CALENDAR_AVAILABILITY_NOT_FOUND | No available time slots found |
CALENDAR_NOTE_TAKER_COMPLETED | Meeting notes are ready |
Workflow Events
Workflow events cover run lifecycle, node progress, contact resolution, workflow publication, and a person waiting at a Review node (coming soon).
Candidate Processing Events
Know when a candidate you submitted has been extracted, enriched and indexed for internal sourcing.
| Event | Description |
|---|---|
CANDIDATE_PROCESSING_STARTED | A candidate has started processing |
CANDIDATE_PROCESSING_COMPLETED | A candidate finished processing and is now searchable |
CANDIDATE_PROCESSING_FAILED | Candidate processing failed; errorReason explains why |
View Candidate Processing Events →
Candidate Deletion Events
Know when an asynchronous candidate deletion has finished erasing everything.
| Event | Description |
|---|---|
CANDIDATE_DELETED | A candidate has been erased and no longer exists in your data |
View Candidate Deletion Events →
Candidate List Events
Keep your own lists in sync with candidate lists in Popp. Each event carries the list's externalId and whether the change came from the API or a user.
| Event | Description |
|---|---|
CANDIDATE_LIST_CREATED | A list was created |
CANDIDATE_LIST_UPDATED | A list's title, description, owner or externalId changed |
CANDIDATE_LIST_DELETED | A list was deleted |
CANDIDATE_LIST_MEMBERSHIP_UPDATED | Candidates were added to or removed from a list |
Documentation
- Webhook Event Structure - Understand the payload format
- Webhook Authentication - Secure your webhook endpoints
Updated 1 day ago
