Webhook Settings

Create Webhook Setting

Changed on

Create a new webhook setting. Allowed types:

  • Webhooks::Settings::ApplicantSave - Fires when an applicant is created or updated
  • Webhooks::Settings::ApplicantStateChange - Fires when an applicant's application state changes
  • Webhooks::Settings::Transition - Fires when an applicant transitions between workflow stages (requires strategy; see the parameter description)
  • Webhooks::Settings::CheckrStatus - Fires when a Checkr background check status changes (clear, consider, suspended, engaged, pre_adverse, post_adverse, dispute)
  • Webhooks::Settings::OnfidoStatus - Fires when an Onfido identity verification status changes (clear, consider)
  • Webhooks::Settings::FunnelSave - Fires when an opening is created or updated. The funnel_save payload includes listing_status on accounts running the four-state sourcing model.
  • Webhooks::Settings::FunnelSourcingStatusChange - Accepted only on accounts running the four-state sourcing model. Fires for every sourcing status change after creation, including automatic changes. Never fires on create or when the status is unchanged.
  • Webhooks::Settings::HiringGoalChange - Fires when a hiring goal is modified
  • Webhooks::Settings::HireCreated - Accepted only on seats-enabled accounts. Fires after a hire first acquires a seat and its transaction commits.
  • Webhooks::Settings::PartnerStatus - Fires when a partner integration status changes, and when a First Advantage background-check result or score changes without one
  • Webhooks::Settings::FileStatus - Fires when an uploaded file's status changes
  • Webhooks::Settings::PosthireDataCollectionApproval - Fires when post-hire documents and/or data fields are approved
  • Webhooks::Settings::PosthireWorkerActivation - Fires when a post-hire worker is activated
  • Webhooks::Settings::PosthireWorkerDeactivation - Fires when a post-hire worker is deactivated
  • Webhooks::Settings::PosthireDocumentUploaded - Fires when a document is uploaded for a post-hire worker
  • Webhooks::Settings::LocationSave - Fires when a location is created or updated

Hire created payload

The hire_created body contains event, a UUIDv5 event_id derived from the hire, its ISO 8601 created_at, opening: { id }, hiring_goal: { id, req_id }, seat: { id, seat_external_id }, and applicant: { id }. All resource IDs are external IDs. The Req ID comes from the hire's stored snapshot and is null when absent. hiring_goal and seat are nullable. No applicant name, email, phone, or secure data is included. Retries and resends retain the same event ID; a rehire has a different event ID.

Sourcing status change payload

The funnel_sourcing_status_change event captures each status change and is delivered only after its transaction commits. Its JSON body contains:

  • funnel_id: the opening's external ID.
  • old_status and new_status: the sourcing statuses before and after the change (public, internal, not_posted, or intake_closed).
  • listing_status_trigger: the source of the change, such as api or internal_window, or null when unavailable.
  • user: { "id": "<user external id>" } when a user is attributed to the change, or null otherwise.
  • reason: the recorded reason, such as api, activation_default, deactivation_default, internal_window, or unknown.
  • webhook_call_sequence: an integer that increases with committed changes to the opening.

Deliveries can arrive out of order or be retried. Receivers must retain the highest webhook_call_sequence per funnel_id and ignore deliveries with an equal or lower sequence.

post/v2/webhook_settings

Request

  • Base URL
    https://api.fountain.com
  • URL
    https://api.fountain.com/v2/webhook_settings
  • Auth
    API key in header X-ACCESS-TOKEN

Request body

typestring required

The webhook type (see description for allowed values)

titlestring required

Title for the webhook setting

urlstring required

The HTTPS URL that will receive webhook payloads

authorization_method'no_auth' | 'simple' | 'oauth'

Authorization method

authorization_headerstring

Authorization header value (required if authorization_method is simple)

disabledboolean

Whether the webhook should be disabled

send_secure_databoolean

Whether to include secure data in webhook payloads

strategy'first_stages' | 'hired_stages' | 'rejected_stages' | 'archived_stages' | 'all_stages' | 'selected_stages'

Required for Webhooks::Settings::Transition: which stage transitions fire the webhook. Ignored for other types

stage_idsstring[]

Stage IDs to fire on; required when strategy is selected_stages. Webhooks::Settings::Transition only

minimal_payloadboolean

Whether to send a minimal payload. Webhooks::Settings::Transition only

Response

Created

Changes

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status