Webhook Events

Theary delivers webhook events to notify your application about verification status changes. This document provides exhaustive documentation of all event types, payload structures, and field definitions.

Payload Structure

All webhook events follow this structure:

{
  "event": "<WebhookEventType>",
  "occurredAt": "<ISO 8601 timestamp>",
  "data": {
    /* Event-specific payload */
  }
}

Top-Level Fields

Field	Type	Required	Description
`event`	`WebhookEventType`	Yes	Event type identifier. One of: `verification.completed`, `verification.action_required`, `verification.notification`
`occurredAt`	`string` (ISO 8601)	Yes	Timestamp when the event was generated
`data`	`object`	Yes	Event-specific payload. Structure varies by event type

WebhookEventType Enum

Value	Description
`verification.completed`	Verification search completed with results
`verification.action_required`	Verification requires manual intervention
`verification.notification`	Intermediate notification during verification process

HTTP Headers

Every webhook request includes these headers:

Header	Type	Description
`Content-Type`	`string`	Always `application/json`
`X-Event-Type`	`WebhookEventType`	Event type (e.g., `verification.completed`)
`X-Event-Id`	`string` (UUID)	Unique delivery identifier for idempotency
`X-Search-Type`	`SearchType`	Search type when available (e.g., `EMPLOYMENT`)
`X-External-Search-Id`	`string`	External identifier provided at order creation
`X-Endpoint-Source`	`string`	Routing source: `type-specific` or `fallback`
`User-Agent`	`string`	Always `Theary-Webhook-Delivery/1.0`
`Authorization`	`string`	Basic auth header when configured (format: `Basic <base64>`)
`X-Webhook-Signature`	`string`	HMAC-SHA256 signature when secret is configured

Signature Verification

Webhooks are signed using HMAC-SHA256. The signature is provided in the X-Webhook-Signature header with format sha256=<hex>.

const crypto = require('crypto')

function verifyWebhookSignature(rawBody, signature, secret) {
  const signatureValue = signature.replace('sha256=', '')
  const expectedSignature = crypto.createHmac('sha256', secret).update(rawBody, 'utf8').digest('hex')

  return crypto.timingSafeEqual(Buffer.from(signatureValue, 'hex'), Buffer.from(expectedSignature, 'hex'))
}

Important: Always verify using the raw request body bytes, not parsed JSON.

Common Enums

SearchType

Value	Description
`EMPLOYMENT`	Employment verification
`EDUCATION`	Education/credential verification
`CRIMINAL`	Criminal background check
`REFERENCE`	Professional reference check

VerificationChannel

Value	Description
`EMAIL`	Email communication channel
`VOICE`	Phone/voice communication channel
`FAX`	Fax communication channel

StandardOutcomeCode

Value	Terminal	Description
`VERIFIED`	Yes	Information successfully verified
`NO_RECORD`	Yes	No record found for the subject
`THIRD_PARTY`	Yes	Requires third-party vendor completion
`WRONG_ORG`	Yes	Request misdirected to wrong organization
`INFO_REQUESTED`	No	Additional information requested
`INSUFFICIENT`	No	Insufficient information to proceed
`RECEIVED`	No	Request received, processing
`STARTED`	No	Verification process started
`SENT`	No	Outbound communication sent
`FAILED`	No	Attempt failed (retryable)
`SUPPRESSED`	No	Communication suppressed

Event: verification.completed

Sent when a verification search completes with results.

Data Fields

Field	Type	Required	Description
`searchId`	`string` (UUID)	Yes	Unique search identifier
`verificationId`	`string` (UUID)	Yes	Verification result identifier
`externalSearchId`	`string`	No	External identifier from order creation
`searchType`	`SearchType`	No	Type of verification performed
`status`	`string`	No	Human-readable status (e.g., `QA Review`, `Completed`)
`channel`	`VerificationChannel`	No	Terminal channel that completed the verification
`verificationResult`	`VerificationResult`	Yes	Complete verification result object
`accreditation`	`AccreditationResult`	No	Accreditation data (education searches only)

VerificationResult Object

Field	Type	Required	Description
`id`	`string` (UUID)	Yes	Verification result primary key
`searchId`	`string` (UUID)	Yes	Associated search ID
`outcome`	`StandardOutcomeCode`	Yes	Verification outcome
`resultDetails`	`string` or `object`	No	Raw extraction data (JSON)
`extractedData`	`object`	No	Parsed extraction data
`submittedAt`	`string` (ISO 8601)	No	When result was submitted
`createdAt`	`string` (ISO 8601)	No	Record creation timestamp
`updatedAt`	`string` (ISO 8601)	No	Record update timestamp
`channel`	`VerificationChannel`	No	Channel that produced the result
`additionalComments`	`string`	No	Free-form notes from verification
`discrepancy`	`boolean`	No	True if verified data differs from provided data
`employmentVerification`	`EmploymentVerification`	Conditional	Present for `EMPLOYMENT` searches
`educationVerification`	`EducationVerification`	Conditional	Present for `EDUCATION` searches
`verifier`	`VerifierProfile`	No	Verifier contact information

VerifierProfile Object

Field	Type	Required	Description
`firstName`	`string`	No	Verifier’s first name
`lastName`	`string`	No	Verifier’s last name
`position`	`string`	No	Verifier’s job title or role

EmploymentVerification Object

Complete employment verification data with provided (claimed) and verified fields.

Provided Fields (from applicant/requester)

Field	Type	Description
`providedCompanyName`	`string`	Claimed employer name
`providedContactName`	`string`	Contact name provided
`providedContactNumber`	`string`	Contact phone provided
`providedContactEmail`	`string`	Contact email provided
`providedLocation`	`string`	Employer location
`providedStartDate`	`string` (YYYY-MM-DD)	Claimed employment start date
`providedEndDate`	`string` (YYYY-MM-DD)	Claimed employment end date
`providedPosition`	`string`	Claimed job title
`providedSalary`	`string`	Claimed compensation
`providedAddress1`	`string`	Employer address line 1
`providedAddress2`	`string`	Employer address line 2
`providedCity`	`string`	Employer city
`providedState`	`string`	Employer state
`providedZip`	`string`	Employer postal code

Verified Fields (from verification)

Field	Type	Description
`verifiedEntityId`	`string`	Internal employer entity ID
`verifiedCompanyName`	`string`	Confirmed employer name
`verifiedContactName`	`string`	Name of person who verified
`verifiedContactNumber`	`string`	Verified contact phone
`verifiedContactEmail`	`string`	Verified contact email
`verifiedLocation`	`string`	Confirmed employer location
`verifiedPosition`	`string`	Confirmed job title
`verifiedSalary`	`string`	Confirmed compensation
`verifiedContactId`	`string`	Internal contact entity ID
`verifiedStartDate`	`string` (YYYY-MM-DD)	Confirmed start date
`verifiedEndDate`	`string` (YYYY-MM-DD)	Confirmed end date
`verifiedReasonLeft`	`string`	Reason for leaving employment
`verifiedRehire`	`boolean` or `null`	Rehire eligibility
`comments`	`string`	Additional verifier comments
`doNotContact`	`boolean`	Do-not-contact flag from request
`verifierFirstName`	`string`	Verifier first name
`verifierLastName`	`string`	Verifier last name
`verifierPosition`	`string`	Verifier job title

Example: Employment Verification (Email)

{
  "event": "verification.completed",
  "occurredAt": "2025-12-02T15:30:00.000Z",
  "data": {
    "searchId": "550e8400-e29b-41d4-a716-446655440000",
    "verificationId": "660e8400-e29b-41d4-a716-446655440000",
    "externalSearchId": "candidate-123",
    "searchType": "EMPLOYMENT",
    "status": "Completed",
    "channel": "EMAIL",
    "verificationResult": {
      "id": "770e8400-e29b-41d4-a716-446655440000",
      "searchId": "550e8400-e29b-41d4-a716-446655440000",
      "outcome": "VERIFIED",
      "submittedAt": "2025-12-02T15:30:00.000Z",
      "createdAt": "2025-12-02T14:00:00.000Z",
      "updatedAt": "2025-12-02T15:30:00.000Z",
      "channel": "EMAIL",
      "additionalComments": "Verification completed via email response",
      "discrepancy": false,
      "extractedData": {
        "employmentVerified": true,
        "employerName": "Acme Corporation",
        "jobTitle": "Software Engineer",
        "startDate": "2020-01-15",
        "endDate": "2023-12-31",
        "rehireEligibility": "Yes, eligible for rehire",
        "reasonForLeaving": "Accepted position at another company",
        "confidence": 0.95
      },
      "employmentVerification": {
        "providedCompanyName": "Acme Corporation",
        "providedPosition": "Software Engineer",
        "providedStartDate": "2020-01-15",
        "providedEndDate": "2023-12-31",
        "providedContactName": null,
        "providedContactNumber": null,
        "providedContactEmail": null,
        "providedLocation": "San Francisco, CA",
        "providedSalary": null,
        "providedAddress1": null,
        "providedAddress2": null,
        "providedCity": "San Francisco",
        "providedState": "CA",
        "providedZip": null,
        "verifiedEntityId": null,
        "verifiedCompanyName": "Acme Corporation",
        "verifiedContactName": "Marcia Harris",
        "verifiedContactNumber": "+14155551234",
        "verifiedContactEmail": "[email protected]",
        "verifiedLocation": "San Francisco, CA",
        "verifiedPosition": "Software Engineer",
        "verifiedSalary": "$145,000/year",
        "verifiedContactId": null,
        "verifiedStartDate": "2020-01-15",
        "verifiedEndDate": "2023-12-31",
        "verifiedReasonLeft": "Accepted position at another company",
        "verifiedRehire": true,
        "comments": "Employee left in good standing",
        "doNotContact": false,
        "verifierFirstName": "Marcia",
        "verifierLastName": "Harris",
        "verifierPosition": "HR Manager"
      },
      "verifier": {
        "firstName": "Marcia",
        "lastName": "Harris",
        "position": "HR Manager"
      }
    }
  }
}

Example: Employment Verification (Voice)

{
  "event": "verification.completed",
  "occurredAt": "2025-12-02T11:45:00.000Z",
  "data": {
    "searchId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "verificationId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
    "externalSearchId": "emp-verify-456",
    "searchType": "EMPLOYMENT",
    "status": "Completed",
    "channel": "VOICE",
    "verificationResult": {
      "id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
      "searchId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "outcome": "VERIFIED",
      "submittedAt": "2025-12-02T11:45:00.000Z",
      "createdAt": "2025-12-02T11:30:00.000Z",
      "updatedAt": "2025-12-02T11:45:00.000Z",
      "channel": "VOICE",
      "additionalComments": "Verified via phone call with HR department",
      "discrepancy": true,
      "extractedData": {
        "employmentVerified": true,
        "employerName": "Tech Solutions Inc",
        "jobTitle": "Senior Developer",
        "startDate": "2019-03-01",
        "endDate": "2024-06-15",
        "confidence": 0.92
      },
      "employmentVerification": {
        "providedCompanyName": "Tech Solutions",
        "providedPosition": "Developer",
        "providedStartDate": "2019-03-15",
        "providedEndDate": "2024-06-30",
        "providedContactName": null,
        "providedContactNumber": "+18005551234",
        "providedContactEmail": null,
        "providedLocation": "Austin, TX",
        "providedSalary": null,
        "providedAddress1": null,
        "providedAddress2": null,
        "providedCity": "Austin",
        "providedState": "TX",
        "providedZip": null,
        "verifiedEntityId": null,
        "verifiedCompanyName": "Tech Solutions Inc",
        "verifiedContactName": "James Wilson",
        "verifiedContactNumber": "+15125559876",
        "verifiedContactEmail": null,
        "verifiedLocation": "Austin, TX",
        "verifiedPosition": "Senior Developer",
        "verifiedSalary": null,
        "verifiedContactId": null,
        "verifiedStartDate": "2019-03-01",
        "verifiedEndDate": "2024-06-15",
        "verifiedReasonLeft": null,
        "verifiedRehire": null,
        "comments": "Title was Senior Developer, not Developer. Start date was March 1, not March 15.",
        "doNotContact": false,
        "verifierFirstName": "James",
        "verifierLastName": "Wilson",
        "verifierPosition": "HR Coordinator"
      },
      "verifier": {
        "firstName": "James",
        "lastName": "Wilson",
        "position": "HR Coordinator"
      }
    }
  }
}

EducationVerification Object

Complete education verification data with provided and verified fields.

Provided Fields

Field	Type	Description
`providedSchoolName`	`string`	Claimed institution name
`providedLocation`	`string`	Institution location
`providedAddress1`	`string`	Address line 1
`providedAddress2`	`string`	Address line 2
`providedCity`	`string`	City
`providedState`	`string`	State
`providedZip`	`string`	Postal code
`providedContactName`	`string`	Contact name
`providedContactNumber`	`string`	Contact phone
`providedContactEmail`	`string`	Contact email
`providedDegree`	`string`	Claimed degree
`providedMajor`	`string`	Claimed major
`providedMinor`	`string`	Claimed minor
`providedStartDate`	`string` (YYYY-MM-DD)	Attendance start date
`providedEndDate`	`string` (YYYY-MM-DD)	Attendance end date
`providedGraduated`	`string`	Graduation status claimed
`providedGraduationDate`	`string` (YYYY-MM-DD)	Claimed graduation date

Verified Fields

Field	Type	Description
`verifiedEntityId`	`string`	Internal institution entity ID
`verifiedSchoolName`	`string`	Confirmed institution name
`verifiedLocation`	`string`	Confirmed location
`verifiedDegree`	`string`	Confirmed degree
`verifiedMajor`	`string`	Confirmed major
`verifiedMinor`	`string`	Confirmed minor
`verifiedGpa`	`string`	Confirmed GPA
`verifiedStartDate`	`string` (YYYY-MM-DD)	Confirmed start date
`verifiedEndDate`	`string` (YYYY-MM-DD)	Confirmed end date
`verifiedGraduated`	`string`	Confirmed graduation status
`verifiedGraduationDate`	`string` (YYYY-MM-DD)	Confirmed graduation date
`verifiedContactName`	`string`	Registrar/contact name
`verifiedContactNumber`	`string`	Contact phone
`verifiedContactEmail`	`string`	Contact email
`comments`	`string`	Additional comments
`verifierFirstName`	`string`	Verifier first name
`verifierLastName`	`string`	Verifier last name
`verifierPosition`	`string`	Verifier title

Example: Education Verification (Fax)

{
  "event": "verification.completed",
  "occurredAt": "2025-12-02T16:45:00.000Z",
  "data": {
    "searchId": "ed9a2f9e-0bf5-4aa2-ac7a-9f4c42355940",
    "verificationId": "vr_f1c64c38-6403-49c9-91af-127c7fcb8f4c",
    "externalSearchId": "edu-verify-880",
    "searchType": "EDUCATION",
    "status": "Completed",
    "channel": "FAX",
    "verificationResult": {
      "id": "vr_f1c64c38-6403-49c9-91af-127c7fcb8f4c",
      "searchId": "ed9a2f9e-0bf5-4aa2-ac7a-9f4c42355940",
      "outcome": "VERIFIED",
      "submittedAt": "2025-12-02T16:45:00.000Z",
      "createdAt": "2025-11-28T09:12:44.000Z",
      "updatedAt": "2025-12-02T16:45:00.000Z",
      "channel": "FAX",
      "additionalComments": "Sealed transcript received via fax",
      "discrepancy": false,
      "extractedData": {
        "educationVerified": true,
        "institutionName": "Stanford University",
        "qualification": "Bachelor of Science",
        "fieldOfStudy": "Computer Science",
        "graduationDate": "2022-06-12",
        "gpa": "3.84/4.0",
        "confidence": 0.97
      },
      "educationVerification": {
        "providedSchoolName": "Stanford University",
        "providedLocation": "Stanford, CA",
        "providedAddress1": null,
        "providedAddress2": null,
        "providedCity": "Stanford",
        "providedState": "CA",
        "providedZip": "94305",
        "providedContactName": null,
        "providedContactNumber": null,
        "providedContactEmail": null,
        "providedDegree": "BS Computer Science",
        "providedMajor": "Computer Science",
        "providedMinor": null,
        "providedStartDate": "2018-09-01",
        "providedEndDate": "2022-06-15",
        "providedGraduated": "Yes",
        "providedGraduationDate": "2022-06-15",
        "verifiedEntityId": null,
        "verifiedSchoolName": "Stanford University",
        "verifiedLocation": "Stanford, CA",
        "verifiedDegree": "Bachelor of Science",
        "verifiedMajor": "Computer Science",
        "verifiedMinor": null,
        "verifiedGpa": "3.84/4.0",
        "verifiedStartDate": "2018-09-01",
        "verifiedEndDate": "2022-06-12",
        "verifiedGraduated": "Yes",
        "verifiedGraduationDate": "2022-06-12",
        "verifiedContactName": "Registrar Services",
        "verifiedContactNumber": "+16507232300",
        "verifiedContactEmail": "[email protected]",
        "comments": "Confirmed via sealed transcript",
        "verifierFirstName": "Regina",
        "verifierLastName": "Sloane",
        "verifierPosition": "Registrar"
      },
      "verifier": {
        "firstName": "Regina",
        "lastName": "Sloane",
        "position": "Registrar"
      }
    },
    "accreditation": {
      "reference": {
        "name": "Stanford University",
        "date": "2022-06-12",
        "city": "Stanford",
        "state": "CA"
      },
      "matches": [
        {
          "campus": {
            "dapipId": "243744",
            "locationName": "Stanford University",
            "parentInstitution": null,
            "locationType": "Institution",
            "city": "Stanford",
            "state": "CA",
            "address": "450 Serra Mall, Stanford, CA 94305",
            "url": "https://www.stanford.edu"
          },
          "accreditation": {
            "statusLabel": "Accredited",
            "isAccredited": true,
            "accreditor": "Western Association of Schools and Colleges, Senior College and University Commission",
            "programName": "Institutional Accreditation",
            "validFrom": "1949-01-01",
            "validThrough": null,
            "reason": "Accredited by WASC Senior College and University Commission from 1949-01-01 through present",
            "latestAction": {
              "date": "2024-05-15",
              "description": "Renewal of Accreditation",
              "justification": "In compliance with all accreditation standards",
              "agencyName": "WASC Senior College and University Commission"
            },
            "recordTimeline": [
              {
                "status": "Accredited",
                "accreditor": "WASC Senior College and University Commission",
                "programName": "Institutional Accreditation",
                "startDate": "1949-01-01",
                "endDate": null
              }
            ]
          }
        }
      ],
      "suggestions": [],
      "metadata": {
        "campusesConsidered": 1,
        "checkedOn": "2025-12-02",
        "dataSource": "apps/verification-api/data/accreditation (InstitutionCampus, AccreditationRecords, AccreditationActions)",
        "accreditationStatus": "accredited"
      }
    }
  }
}

Example: Education Verification (No Record)

{
  "event": "verification.completed",
  "occurredAt": "2025-12-02T14:20:00.000Z",
  "data": {
    "searchId": "norecord-1234-5678-abcd-ef0123456789",
    "verificationId": "vr_norecord-9876-5432-dcba-fedcba987654",
    "externalSearchId": "edu-check-999",
    "searchType": "EDUCATION",
    "status": "Completed",
    "channel": "EMAIL",
    "verificationResult": {
      "id": "vr_norecord-9876-5432-dcba-fedcba987654",
      "searchId": "norecord-1234-5678-abcd-ef0123456789",
      "outcome": "NO_RECORD",
      "submittedAt": "2025-12-02T14:20:00.000Z",
      "createdAt": "2025-12-01T10:00:00.000Z",
      "updatedAt": "2025-12-02T14:20:00.000Z",
      "channel": "EMAIL",
      "additionalComments": "No enrollment record found for this individual",
      "discrepancy": false,
      "extractedData": {
        "educationVerified": false,
        "noRecord": true,
        "confidence": 0.95
      },
      "educationVerification": {
        "providedSchoolName": "State University",
        "providedLocation": "Columbus, OH",
        "providedDegree": "Bachelor of Arts",
        "providedMajor": "Psychology",
        "providedGraduationDate": "2019-05-15",
        "verifiedSchoolName": "State University",
        "verifiedDegree": null,
        "verifiedMajor": null,
        "verifiedGraduationDate": null,
        "comments": "Registrar confirmed no enrollment record exists for this individual"
      }
    }
  }
}

AccreditationResult Object

Included in education verification webhooks (verification.completed and verification.action_required).

Field	Type	Description
`reference`	`AccreditationReference`	Input parameters used for lookup
`matches`	`AccreditationMatch[]`	Exact campus/institution matches
`suggestions`	`CampusSummary[]`	Alternate campuses when no exact match
`metadata`	`AccreditationMetadata`	Lookup metadata and status
`note`	`string`	Present when matches is empty; review instructions

AccreditationReference Object

Field	Type	Description
`name`	`string`	Institution name used for lookup
`date`	`string`	Reference date (graduation/attendance)
`city`	`string`	City filter
`state`	`string`	State filter

AccreditationMatch Object

Field	Type	Description
`campus`	`CampusSummary`	Campus/institution details
`accreditation`	`AccreditationEvaluation`	Accreditation status details

CampusSummary Object

Field	Type	Description
`dapipId`	`string`	Database of Accredited Postsecondary Institutions ID
`locationName`	`string`	Campus name
`parentInstitution`	`string`	Parent institution name
`locationType`	`string`	Type: `Institution`, `Branch`, etc.
`city`	`string`	City
`state`	`string`	State
`address`	`string`	Full address
`url`	`string`	Institution website

AccreditationEvaluation Object

Field	Type	Description
`statusLabel`	`string`	Human-readable status
`isAccredited`	`boolean`	Accreditation status
`accreditor`	`string`	Accrediting agency name
`programName`	`string`	Accreditation program
`validFrom`	`string`	Accreditation start date
`validThrough`	`string`	Accreditation end date (null if ongoing)
`reason`	`string`	Explanation of accreditation status
`latestAction`	`AccreditationAction`	Most recent accreditation action
`recordTimeline`	`AccreditationTimelineItem[]`	Historical accreditation records

AccreditationMetadata Object

Field	Type	Description
`campusesConsidered`	`number`	Number of campuses evaluated
`checkedOn`	`string`	Date of accreditation check
`dataSource`	`string`	Data source identifier
`accreditationStatus`	`AccreditationStatus`	Aggregated status

AccreditationStatus Enum

Value	Description
`accredited`	Institution is currently accredited
`not_accredited`	Institution is not accredited
`unknown`	Accreditation status could not be determined
`not_found`	No matching institution found

Event: verification.action_required

Sent when verification cannot proceed without manual intervention.

Data Fields

Field	Type	Required	Description
`searchId`	`string` (UUID)	Yes	Search identifier
`verificationId`	`string` (UUID)	No	Present when verification record exists
`externalSearchId`	`string`	No	External identifier
`searchType`	`SearchType`	No	Type of verification
`reasonCode`	`ActionRequiredReasonCode`	Yes	Machine-readable reason code
`status`	`string`	No	Human-readable status
`channel`	`VerificationChannel`	No	Channel that triggered the action
`contact`	`ContactPayload`	No	Structured contact information
`metadata`	`object`	No	Additional context and troubleshooting data
`accreditation`	`AccreditationResult`	No	Accreditation data (education with `THIRD_PARTY_RECORD`)

ActionRequiredReasonCode Enum

Code	Description	When Triggered
`THIRD_PARTY_RECORD`	Requires third-party vendor	Research identified paywalled portal or vendor
`UPSTREAM_ISSUE`	External service failure	Fax provider outage, email throttling, API failure
`SYSTEM_FAILURE`	Internal system error	Database issue, workflow crash
`SLA_REACHED`	SLA timeout exceeded	Search exceeded SLA without result
`HUMAN_ESCALATION`	Automation exhausted	No contacts found, retry cap hit, manual review needed
`OTHER`	Catch-all	Cases not matching other codes

ContactPayload Object

Structured contact information based on search type.

Field	Type	Description
`type`	`string`	Contact type: `EMPLOYMENT`, `EDUCATION`, `LICENSE`, `REFERENCE`
`data`	`object`	Type-specific contact data

EmploymentContactPayload

Field	Type	Description
`providedCompanyName`	`string`	Employer name
`providedContactName`	`string`	Contact name
`providedContactNumber`	`string`	Contact phone
`providedContactEmail`	`string`	Contact email
`providedLocation`	`string`	Employer location
`providedStartDate`	`string`	Employment start date
`providedEndDate`	`string`	Employment end date
`providedPosition`	`string`	Job title
`providedSalary`	`string`	Compensation
`providedAddress1`	`string`	Address line 1
`providedAddress2`	`string`	Address line 2
`providedCity`	`string`	City
`providedState`	`string`	State
`providedZip`	`string`	Postal code
`doNotContact`	`boolean`	Do-not-contact flag

EducationContactPayload

Field	Type	Description
`providedSchoolName`	`string`	Institution name
`providedLocation`	`string`	Institution location
`providedAddress1`	`string`	Address line 1
`providedAddress2`	`string`	Address line 2
`providedCity`	`string`	City
`providedState`	`string`	State
`providedZip`	`string`	Postal code
`providedContactName`	`string`	Contact name
`providedContactNumber`	`string`	Contact phone
`providedContactEmail`	`string`	Contact email
`providedDegree`	`string`	Degree
`providedMajor`	`string`	Major
`providedMinor`	`string`	Minor
`providedStartDate`	`string`	Attendance start
`providedEndDate`	`string`	Attendance end
`providedGraduated`	`string`	Graduation status
`providedGraduationDate`	`string`	Graduation date

LicenseContactPayload

Field	Type	Description
`providedAgency`	`string`	Licensing agency
`providedLicenseName`	`string`	License/certification name
`providedLicenseNumber`	`string`	License number
`providedReceiveDate`	`string`	Issue date
`providedExpireDate`	`string`	Expiration date
`providedState`	`string`	Issuing jurisdiction

ReferenceContactPayload

Field	Type	Description
`providedCompanyName`	`string`	Company associated with reference
`providedReferenceName`	`string`	Reference contact name
`providedReferencePhone`	`string`	Reference phone
`providedReferenceEmail`	`string`	Reference email
`providedType`	`string`	Relationship type (e.g., `peer`, `manager`)
`providedRelationship`	`string`	Relationship details
`providedReferenceAddress`	`string`	Reference address
`providedReferenceCity`	`string`	City
`providedReferenceState`	`string`	State
`providedReferenceZip`	`string`	Postal code
`providedLocation`	`string`	Location summary
`providedComments`	`string`	Additional notes

Example: THIRD_PARTY_RECORD (Employment)

{
  "event": "verification.action_required",
  "occurredAt": "2025-12-02T10:15:00.000Z",
  "data": {
    "searchId": "7b0463ae-a338-4b5f-bd5c-b3ef2e6e5ccc",
    "externalSearchId": "emp-001",
    "searchType": "EMPLOYMENT",
    "reasonCode": "THIRD_PARTY_RECORD",
    "status": "QA Review",
    "channel": "EMAIL",
    "metadata": {
      "source": "research",
      "contactIndex": 0,
      "vendor": "THE_WORK_NUMBER",
      "vendorCode": "15619",
      "vendorMatched": "TWN 15619 - uses The Work Number exclusively"
    },
    "contact": {
      "type": "EMPLOYMENT",
      "data": {
        "providedCompanyName": "Major Hospital Network",
        "providedContactName": "HR Department",
        "providedPosition": "Registered Nurse",
        "providedStartDate": "2020-03-15",
        "providedEndDate": "2024-08-01",
        "doNotContact": false
      }
    }
  }
}

Example: THIRD_PARTY_RECORD (Education with Accreditation)

{
  "event": "verification.action_required",
  "occurredAt": "2025-12-02T18:05:00.000Z",
  "data": {
    "searchId": "ed_7b0463ae-a338-4b5f-bd5c-b3ef2e6e5ccc",
    "externalSearchId": "edu-req-90210",
    "searchType": "EDUCATION",
    "reasonCode": "THIRD_PARTY_RECORD",
    "status": "QA Review",
    "channel": "EMAIL",
    "metadata": {
      "source": "research",
      "contactIndex": 0,
      "vendor": "PARCHMENT",
      "vendorCode": "DIST-90833",
      "vendorMatched": "Parchment portal only"
    },
    "contact": {
      "type": "EDUCATION",
      "data": {
        "providedSchoolName": "Metro High School District",
        "providedLocation": "Memphis, TN",
        "providedContactName": "Records Office",
        "providedContactEmail": "[email protected]",
        "providedContactNumber": "+19015445566",
        "providedGraduationDate": "2018-05-25"
      }
    },
    "accreditation": {
      "reference": {
        "name": "Metro High School District",
        "date": "2018-05-25",
        "city": "Memphis",
        "state": "TN"
      },
      "matches": [
        {
          "campus": {
            "dapipId": "123456",
            "locationName": "Metro High School District",
            "city": "Memphis",
            "state": "TN",
            "url": "https://www.metrohsd.gov"
          },
          "accreditation": {
            "statusLabel": "Accredited",
            "isAccredited": true,
            "accreditor": "SACS",
            "reason": "Accredited by Southern Association of Colleges and Schools"
          }
        }
      ],
      "metadata": {
        "accreditationStatus": "accredited",
        "campusesConsidered": 1,
        "dataSource": "apps/verification-api/data/accreditation",
        "checkedOn": "2025-12-02"
      }
    }
  }
}

Example: UPSTREAM_ISSUE

{
  "event": "verification.action_required",
  "occurredAt": "2025-12-02T06:12:00.000Z",
  "data": {
    "searchId": "search_voice_fax_884",
    "externalSearchId": "emp-upstream-001",
    "searchType": "EMPLOYMENT",
    "reasonCode": "UPSTREAM_ISSUE",
    "status": "Outbound Retry Cap",
    "channel": "EMAIL",
    "metadata": {
      "provider": "azureEmail",
      "errorCategory": "provider_timeout",
      "message": "Microsoft Graph throttled mailbox after 5 consecutive 503 responses",
      "lastAttemptAt": "2025-12-02T05:58:00.000Z",
      "retryCount": 3
    }
  }
}

Example: SYSTEM_FAILURE

{
  "event": "verification.action_required",
  "occurredAt": "2025-12-02T14:30:00.000Z",
  "data": {
    "searchId": "ed_verif_540",
    "externalSearchId": "edu-sys-001",
    "searchType": "EDUCATION",
    "reasonCode": "SYSTEM_FAILURE",
    "status": "Workflow Error",
    "channel": "FAX",
    "metadata": {
      "errorCategory": "system",
      "stackId": "wf_education_outbound_20251202T1425",
      "retryCount": 1,
      "note": "Prisma write failure while persisting fax metadata"
    }
  }
}

Example: SLA_REACHED

{
  "event": "verification.action_required",
  "occurredAt": "2025-12-02T18:22:00.000Z",
  "data": {
    "searchId": "lic_0f6b69ec-4de5-49a5-9aa0-3e94f3c6c4db",
    "externalSearchId": "lic-sla-001",
    "searchType": "LICENSE",
    "reasonCode": "SLA_REACHED",
    "status": "Awaiting Applicant Docs",
    "channel": "VOICE",
    "metadata": {
      "slaHours": 24,
      "elapsedMinutes": 1560,
      "lastAttemptAt": "2025-12-02T17:55:00.000Z",
      "reassignmentWindowMinutes": 2880,
      "note": "State board requires signed release"
    },
    "contact": {
      "type": "LICENSE",
      "data": {
        "providedAgency": "Texas Board of Nursing",
        "providedLicenseNumber": "RN-789654",
        "providedLicenseName": "Registered Nurse",
        "providedState": "TX"
      }
    }
  }
}

Example: HUMAN_ESCALATION

{
  "event": "verification.action_required",
  "occurredAt": "2025-12-02T10:00:00.000Z",
  "data": {
    "searchId": "emp_7f8e9d0a-1b2c-3d4e-5f6a-7b8c9d0e1f2a",
    "externalSearchId": "emp-escalate-001",
    "searchType": "EMPLOYMENT",
    "reasonCode": "HUMAN_ESCALATION",
    "status": "QA Review",
    "channel": "EMAIL",
    "metadata": {
      "source": "automatic_reassignment",
      "createdAt": "2025-11-30T10:00:00.000Z",
      "reassignedAt": "2025-12-02T10:00:00.000Z",
      "outboundWindowMinutes": 1440,
      "reassignmentWindowMinutes": 2880,
      "exceededSla": true,
      "reachedReassignmentWindow": true,
      "contactPlan": {
        "contactResults": [
          {
            "source": "primary",
            "phone": "+14255551234",
            "email": "[email protected]",
            "confidence": 0.85,
            "metadata": {
              "title": "HR Manager",
              "department": "Human Resources"
            }
          }
        ],
        "researchNotes": "Found direct HR contact via company website",
        "researchConfidence": 0.92
      }
    }
  }
}

Example: OTHER

{
  "event": "verification.action_required",
  "occurredAt": "2025-12-02T09:15:00.000Z",
  "data": {
    "searchId": "ref_1205",
    "externalSearchId": "ref-other-001",
    "searchType": "REFERENCE",
    "reasonCode": "OTHER",
    "status": "Needs Clarification",
    "channel": "EMAIL",
    "metadata": {
      "note": "Reference replied with partial data; applicant name mismatch requires confirmation",
      "requiresHumanReview": true
    }
  }
}

Event: verification.notification

Sent during intermediate stages of verification process.

Data Fields

Field	Type	Required	Description
`searchId`	`string` (UUID)	Yes	Search identifier
`externalSearchId`	`string`	No	External identifier
`verificationId`	`string` (UUID)	No	Verification record ID when linked
`searchType`	`SearchType`	No	Type of verification
`notificationType`	`VerificationNotificationType`	No	Notification category
`messageId`	`string`	No	Provider message ID
`threadId`	`string`	No	Conversation thread ID
`from`	`string`	No	Sender identity
`subject`	`string`	No	Subject/description
`classification`	`Classification`	No	Message classification
`channels`	`VerificationChannel[]`	No	Active channels
`contactPlan`	`ContactPlanEntry[]`	No	Contact plan (when `notificationType` is `CONTACT_PLAN`)
`outboundAttempt`	`OutboundAttempt`	No	Attempt details (when `notificationType` is `OUTBOUND_ATTEMPT`)
`inboundMetadata`	`InboundMetadata`	No	Inbound details (when `notificationType` is `INBOUND_MESSAGE`)

VerificationNotificationType Enum

Value	Description
`CONTACT_PLAN`	Research identified viable contacts
`OUTBOUND_ATTEMPT`	Outbound communication attempt made
`INBOUND_MESSAGE`	Inbound communication received

Classification Object

Field	Type	Description
`type`	`string`	Classification label (e.g., `VERIFICATION_RESPONSE`, `CALLBACK_REQUEST`, `INFO_REQUEST`)
`confidence`	`number`	Confidence score (0-1)

ContactPlanEntry Object

Field	Type	Description
`name`	`string`	Contact name
`title`	`string`	Job title/role
`entityName`	`string`	Organization name
`location`	`string`	Location
`method`	`string`	Contact method: `EMAIL`, `VOICE`, `FAX`, or `THIRD_PARTY`
`destination`	`string`	Email, phone, fax number, or vendor ID
`source`	`string`	Research source (e.g., `Search history`, `Web`)

OutboundAttempt Object

Field	Type	Description
`channel`	`VerificationChannel`	Channel used
`attemptNumber`	`number`	1-based attempt index
`contactName`	`string`	Contact name
`contactTitle`	`string`	Contact title
`contactEntity`	`string`	Organization
`destination`	`string`	Email/phone/fax destination
`metadata`	`object`	Channel-specific details (e.g., `{ "callId": "..." }`)

InboundMetadata Object

Field	Type	Description
`summary`	`string`	Content summary
`title`	`string`	Headline/title
`ticketUrl`	`string`	Link to ticket/entry
`linkLabel`	`string`	Display label for URL
`source`	`string`	Source (e.g., `MICROSOFT_GRAPH`, `FAX_WEBHOOK`)

Example: CONTACT_PLAN

{
  "event": "verification.notification",
  "occurredAt": "2025-12-02T15:30:00.000Z",
  "data": {
    "searchId": "7c7b8f66-7f6a-4b52-9e85-8b3f5b7c1111",
    "externalSearchId": "contact-plan-001",
    "searchType": "EMPLOYMENT",
    "notificationType": "CONTACT_PLAN",
    "contactPlan": [
      {
        "name": "Casey Morgan",
        "title": "HR Generalist",
        "entityName": "St. Luke Medical Center",
        "location": "Denver, CO",
        "method": "EMAIL",
        "destination": "[email protected]",
        "source": "Search history"
      },
      {
        "name": "Nurse Staffing Desk",
        "title": null,
        "entityName": "St. Luke Medical Center",
        "location": "Denver, CO",
        "method": "VOICE",
        "destination": "+13035551234",
        "source": "Internal research"
      },
      {
        "name": null,
        "title": null,
        "entityName": "St. Luke Medical Center",
        "location": null,
        "method": "FAX",
        "destination": "+13035559876",
        "source": "Web"
      }
    ]
  }
}

Example: OUTBOUND_ATTEMPT

{
  "event": "verification.notification",
  "occurredAt": "2025-12-02T09:15:00.000Z",
  "data": {
    "searchId": "ba95128e-0e4e-4235-9b08-5554e4c95452",
    "externalSearchId": "emp-885",
    "searchType": "EMPLOYMENT",
    "notificationType": "OUTBOUND_ATTEMPT",
    "outboundAttempt": {
      "attemptNumber": 2,
      "channel": "VOICE",
      "contactName": "Patrice Wynn",
      "contactTitle": "HR Coordinator",
      "contactEntity": "Green Valley Rehab",
      "destination": "+17025559876",
      "metadata": {
        "callId": "call_23cb8da5",
        "callDurationSeconds": 145
      }
    }
  }
}

Example: INBOUND_MESSAGE (Email)

{
  "event": "verification.notification",
  "occurredAt": "2025-12-02T20:00:00.000Z",
  "data": {
    "searchId": "550e8400-e29b-41d4-a716-446655440000",
    "externalSearchId": "candidate-789",
    "verificationId": "660e8400-e29b-41d4-a716-446655440000",
    "searchType": "EMPLOYMENT",
    "notificationType": "INBOUND_MESSAGE",
    "messageId": "msg_abc123",
    "threadId": "thread_xyz789",
    "from": "[email protected]",
    "subject": "RE: Employment Verification Request",
    "classification": {
      "type": "VERIFICATION_RESPONSE",
      "confidence": 0.95
    },
    "channels": ["EMAIL"],
    "inboundMetadata": {
      "summary": "HR confirmed employment dates and job title",
      "source": "MICROSOFT_GRAPH"
    }
  }
}

Example: INBOUND_MESSAGE (Voice)

{
  "event": "verification.notification",
  "occurredAt": "2025-12-02T14:05:00.000Z",
  "data": {
    "searchId": "search_9c1d6a41-5ef1-4c80-9520-8456682e1d9f",
    "externalSearchId": "emp-voice-303",
    "verificationId": "vr_240d4e6a-abc9-4d0d-9e8f-5af18bb8acaf",
    "searchType": "EMPLOYMENT",
    "notificationType": "INBOUND_MESSAGE",
    "messageId": "msg_voice_456",
    "threadId": "thread_aggregate_123",
    "from": "+14255550123",
    "subject": "Voicemail transcription available",
    "classification": {
      "type": "CALLBACK_REQUEST",
      "confidence": 0.81
    },
    "channels": ["VOICE", "EMAIL"],
    "inboundMetadata": {
      "summary": "Caller requested callback to verify employment details",
      "source": "VOICEMAIL_TRANSCRIPTION"
    }
  }
}

Example: INBOUND_MESSAGE (Urgent)

{
  "event": "verification.notification",
  "occurredAt": "2025-12-02T18:04:00.000Z",
  "data": {
    "searchId": "search_04c7821e-8be3-4b4f-82b4-2a32b51e7f10",
    "externalSearchId": "emp-urgent-12",
    "verificationId": "vr_34d4d6e7-0bb1-46da-999b-d3625ddd7a54",
    "searchType": "EMPLOYMENT",
    "notificationType": "INBOUND_MESSAGE",
    "messageId": "msg_8891",
    "threadId": "thread_552",
    "from": "[email protected]",
    "subject": "RE: Verification needs signed release",
    "classification": {
      "type": "INFO_REQUEST",
      "confidence": 0.9
    },
    "channels": ["EMAIL"],
    "inboundMetadata": {
      "summary": "Clinic requires signed authorization before release",
      "title": "Authorization Required",
      "ticketUrl": "https://desk.example.com/tickets/1442",
      "linkLabel": "View Ticket",
      "source": "MICROSOFT_GRAPH"
    }
  }
}

Third-Party Vendor Reference

When reasonCode is THIRD_PARTY_RECORD, the metadata object includes vendor information.

Employment Vendors

Standardized Name	Source Keywords
`THE_WORK_NUMBER`	TALX, The Work Number, INVerify, WNFE
`THOMAS_AND_COMPANY`	Thomas and Company, Thomas & Co
`PRECHECK`	PreCheck, EmpCheck, EmpChek
`VERIFYTODAY`	VerifyToday, Verify Today System
`CCCVERIFY`	CCC Verify, CCCVerify
`EXPERIAN`	uConfirm, Experian Verify
`QUICKCONFIRM`	QuickConfirm
`TRUEWORK`	Truework, True Work
`VERISAFE_JOBS`	Verisafe Jobs
`VAULT_VERIFY`	VaultVerify
`VERIFY_FAST`	Verify Fast, VerifyFast
`VERIFENT`	Verifent
`VERIFY_ADVANTAGE`	VerifyAdvantage
`TENSTREET`	Tenstreet
`TRUECONFIRM`	TrueConfirm
`JOBTRAX`	JobTrax
`VERIFICATION_MANAGER`	Verification Manager

Education Vendors

Standardized Name	Source Keywords
`NSCH_DEGREE_VERIFY`	National Student Clearinghouse, NSC, NSCH, DegreeVerify, DiplomaVerify
`PARCHMENT`	Parchment
`NEED_MY_TRANSCRIPT`	Need My Transcript, NeedMyTranscript, needmytranscript.com
`SCRIBORDER`	ScribOrder, Scrib Order, scriborder.com
`AURADATA`	AuraData, Aura Data, auradata.com
`DIPLOMA_SENDER`	Diploma Sender, diplomasender.com
`CERTREE_EDU`	Certree EDU
`UNKNOWN`	Unrecognized vendor

Retry Policy

Setting	Default	Description
Retry attempts	3	Maximum delivery attempts
Backoff	Exponential	2s, 4s, 8s (with jitter)
4xx errors	Not retried	Client errors are final
5xx errors	Retried	Server errors are retried
Timeout	30 seconds	Per-request timeout

Configuration

Tenant webhook configuration via policy:

{
  "webhook": {
    "enabled": true,
    "secret": "your-webhook-secret",
    "retryAttempts": 3,
    "closeoutEndpoints": {
      "EMPLOYMENT": "https://your-api.com/webhooks/employment",
      "EDUCATION": "https://your-api.com/webhooks/education"
    },
    "fallbackEndpoint": "https://your-api.com/webhooks/verification"
  },
  "policy": {
    "global": {
      "searchSlaMinutes": 1440,
      "reassignmentWindowMinutes": 2880,
      "includeContactPlanInEscalation": false
    }
  }
}

Policy Parameters

Parameter	Default	Description
`searchSlaMinutes`	1440 (24h)	Search SLA in minutes
`reassignmentWindowMinutes`	2880 (48h)	Auto-reassignment window
`includeContactPlanInEscalation`	false	Include research data in escalation webhooks

Best Practices

1. Acknowledge Quickly

Return 2xx within 30 seconds:

app.post('/webhooks', async (req, res) => {
  res.status(200).send('OK')
  processWebhook(req.body).catch(console.error)
})

2. Verify Signatures

const signature = req.headers['x-webhook-signature']
if (!verifyWebhookSignature(req.rawBody, signature, secret)) {
  return res.status(401).send('Invalid signature')
}

3. Handle Idempotency

Use X-Event-Id to detect duplicates:

const eventId = req.headers['x-event-id']
if (await isProcessed(eventId)) {
  return res.status(200).send('Already processed')
}
await processWebhook(req.body)
await markAsProcessed(eventId)

4. Handle All Event Types

app.post('/webhooks', (req, res) => {
  const { event, data } = req.body

  switch (event) {
    case 'verification.completed':
      handleCompleted(data)
      break
    case 'verification.action_required':
      handleActionRequired(data)
      break
    case 'verification.notification':
      handleNotification(data)
      break
  }

  res.status(200).send('OK')
})

Testing

Sample Test Payload

{
  "event": "verification.completed",
  "occurredAt": "2025-12-02T20:00:00.000Z",
  "data": {
    "searchId": "test-search-id",
    "externalSearchId": "test-external-id",
    "verificationId": "test-verification-id",
    "searchType": "EMPLOYMENT",
    "status": "Completed",
    "channel": "EMAIL",
    "verificationResult": {
      "id": "test-result-id",
      "outcome": "VERIFIED",
      "extractedData": {
        "employmentVerified": true,
        "employerName": "Test Company",
        "jobTitle": "Software Engineer",
        "startDate": "2020-01-01",
        "endDate": "2023-12-31",
        "confidence": 0.95
      },
      "channel": "EMAIL"
    }
  }
}

Tools

ngrok: ngrok http 3000 for local testing
webhook.site: Temporary webhook URL for testing
Postman: Import payloads for manual testing

API Reference

Service API

Orders API

Batches API

Inbound API

Files API

Webhooks

Schemas

​Webhook Events

​Payload Structure

​Top-Level Fields

​WebhookEventType Enum

​HTTP Headers

​Signature Verification

​Common Enums

​SearchType

​VerificationChannel

​StandardOutcomeCode

​Event: verification.completed

​Data Fields

​VerificationResult Object

​VerifierProfile Object

​EmploymentVerification Object

​Provided Fields (from applicant/requester)

​Verified Fields (from verification)

​Example: Employment Verification (Email)

​Example: Employment Verification (Voice)

​EducationVerification Object

​Provided Fields

​Verified Fields

​Example: Education Verification (Fax)

​Example: Education Verification (No Record)

​AccreditationResult Object

​AccreditationReference Object

​AccreditationMatch Object

​CampusSummary Object

​AccreditationEvaluation Object

​AccreditationMetadata Object

​AccreditationStatus Enum

​Event: verification.action_required

​Data Fields

​ActionRequiredReasonCode Enum

​ContactPayload Object

​EmploymentContactPayload

​EducationContactPayload

​LicenseContactPayload

​ReferenceContactPayload

​Example: THIRD_PARTY_RECORD (Employment)

​Example: THIRD_PARTY_RECORD (Education with Accreditation)

​Example: UPSTREAM_ISSUE

​Example: SYSTEM_FAILURE

​Example: SLA_REACHED

​Example: HUMAN_ESCALATION

​Example: OTHER

​Event: verification.notification

​Data Fields

​VerificationNotificationType Enum

​Classification Object

​ContactPlanEntry Object

​OutboundAttempt Object

​InboundMetadata Object

​Example: CONTACT_PLAN

​Example: OUTBOUND_ATTEMPT

​Example: INBOUND_MESSAGE (Email)

​Example: INBOUND_MESSAGE (Voice)

​Example: INBOUND_MESSAGE (Urgent)

​Third-Party Vendor Reference

​Employment Vendors

​Education Vendors

​Retry Policy

​Configuration

​Policy Parameters

​Best Practices

​1. Acknowledge Quickly

​2. Verify Signatures

​3. Handle Idempotency

​4. Handle All Event Types

​Testing

​Sample Test Payload

​Tools

Webhook Events

Payload Structure

Top-Level Fields

WebhookEventType Enum

HTTP Headers

Signature Verification

Common Enums

SearchType

VerificationChannel

StandardOutcomeCode

Event: verification.completed

Data Fields

VerificationResult Object

VerifierProfile Object

EmploymentVerification Object

Provided Fields (from applicant/requester)

Verified Fields (from verification)

Example: Employment Verification (Email)

Example: Employment Verification (Voice)

EducationVerification Object

Provided Fields

Verified Fields

Example: Education Verification (Fax)

Example: Education Verification (No Record)

AccreditationResult Object

AccreditationReference Object

AccreditationMatch Object

CampusSummary Object

AccreditationEvaluation Object

AccreditationMetadata Object

AccreditationStatus Enum

Event: verification.action_required

Data Fields

ActionRequiredReasonCode Enum

ContactPayload Object

EmploymentContactPayload

EducationContactPayload

LicenseContactPayload

ReferenceContactPayload

Example: THIRD_PARTY_RECORD (Employment)

Example: THIRD_PARTY_RECORD (Education with Accreditation)

Example: UPSTREAM_ISSUE

Example: SYSTEM_FAILURE

Example: SLA_REACHED

Example: HUMAN_ESCALATION

Example: OTHER

Event: verification.notification

Data Fields

VerificationNotificationType Enum

Classification Object

ContactPlanEntry Object

OutboundAttempt Object

InboundMetadata Object

Example: CONTACT_PLAN

Example: OUTBOUND_ATTEMPT

Example: INBOUND_MESSAGE (Email)

Example: INBOUND_MESSAGE (Voice)

Example: INBOUND_MESSAGE (Urgent)

Third-Party Vendor Reference

Employment Vendors

Education Vendors

Retry Policy

Configuration

Policy Parameters

Best Practices

1. Acknowledge Quickly

2. Verify Signatures

3. Handle Idempotency

4. Handle All Event Types

Testing

Sample Test Payload

Tools