Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.firstwork.com/llms.txt

Use this file to discover all available pages before exploring further.

Overview

Firstwork integrates with Sterling to automate background check and screening workflows. Initiate checks directly from your hiring flows, track results in real-time, and automatically advance or flag candidates based on screening outcomes.

How It Works

Setup

1

Obtain Sterling API credentials

Contact your Sterling account representative for API access credentials.
2

Configure in Firstwork

Add Sterling integration credentials in Settings > Integrations > Sterling:
  • API key
  • Client ID
  • Callback URL
3

Map screening packages

Map your Sterling screening packages to Firstwork hiring flow stages.

Sterling Integration Model

ComponentDescription
Sterling IntegrationCompany-level integration configuration
Sterling ScreeningIndividual screening request and results

Screening Data

Each screening tracks:
  • Candidate information sent to Sterling
  • Screening package requested
  • Status (initiated, in progress, completed, failed)
  • Results and findings
  • Completion timestamp

Automation Integration

Triggering Background Checks

Use automations to initiate Sterling checks:
ConfigurationDescription
TriggerApplication enters “Background Check” stage
ActionWebhook to Sterling API
Data MappingMap candidate data to Sterling fields
CallbackReceive results via webhook trigger

Processing Results

When Sterling returns results via webhook:
  1. Webhook trigger fires in Firstwork
  2. Results are stored in the screening record
  3. Compliance rule evaluates the results
  4. Automation advances or flags the candidate

Supported Screening Types

  • Criminal background checks
  • Employment verification
  • Education verification
  • Drug screening
  • Credit checks
  • Identity verification
  • Motor vehicle records

Monitoring

Track background check status in:
  • Application detail view
  • Automation execution logs
  • Sterling dashboard
  • Analytics widgets