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.

EventDescription
CONVERSATION_QUEUEDConversation is queued and waiting to start
CONVERSATION_STARTEDConversation has started with the candidate
CONVERSATION_COMPLETEDConversation completed successfully
CONVERSATION_NEEDS_REVIEWConversation requires manual review
CONVERSATION_OPTED_OUTCandidate opted out of the conversation
START_CONVERSATION_FAILEDFailed to start the conversation

View Conversation Events →

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.

EventDescription
ANALYSIS_CREATEDA new analysis batch has been created
CANDIDATE_ANALYSIS_COMPLETEDAnalysis for a candidate is complete
CANDIDATE_ANALYSIS_RESCOREDA workflow analysis re-scored an application before the workflow acted on its score (coming soon)
CANDIDATE_ANALYSIS_RESCORED_AFTER_ACTED_ONA workflow analysis re-scored an application after the workflow acted on its score (coming soon)
CANDIDATE_ANALYSIS_FAILEDA workflow analysis could not score an application (coming soon)

View Analysis Events →

Scheduling Events

Track calendar and meeting activities.

EventDescription
CALENDAR_MEETING_SCHEDULEDA meeting has been scheduled
CALENDAR_MEETING_CANCELLEDA meeting has been cancelled
CALENDAR_MEETING_RESCHEDULEDA meeting has been rescheduled
CALENDAR_AVAILABILITY_NOT_FOUNDNo available time slots found
CALENDAR_NOTE_TAKER_COMPLETEDMeeting notes are ready

View Scheduling Events →

Workflow Events

Workflow events cover run lifecycle, node progress, contact resolution, workflow publication, and a person waiting at a Review node (coming soon).

View Workflow Events →

Candidate Processing Events

Know when a candidate you submitted has been extracted, enriched and indexed for internal sourcing.

EventDescription
CANDIDATE_PROCESSING_STARTEDA candidate has started processing
CANDIDATE_PROCESSING_COMPLETEDA candidate finished processing and is now searchable
CANDIDATE_PROCESSING_FAILEDCandidate processing failed; errorReason explains why

View Candidate Processing Events →

Candidate Deletion Events

Know when an asynchronous candidate deletion has finished erasing everything.

EventDescription
CANDIDATE_DELETEDA 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.

EventDescription
CANDIDATE_LIST_CREATEDA list was created
CANDIDATE_LIST_UPDATEDA list's title, description, owner or externalId changed
CANDIDATE_LIST_DELETEDA list was deleted
CANDIDATE_LIST_MEMBERSHIP_UPDATEDCandidates were added to or removed from a list

View Candidate List Events →

Documentation


Did this page help you?