Xref Integration

Automated employment reference checks and candidate verification. Automate Xref hiring, onboarding, and employee updates across your HR stack. When Watch Checks fires, automatically trigger Get a Check or Get a Check's Lifecycle.

Explore Documentation

3-day trialCancel anytimeUp to 10 minutes quick set up

GDPR
Data Encryption
2FA
Local Data Region

Supported triggers and actions for Xref integration

Triggers can detect changes in Xref and run actions that can create, search or modify data inside Xref automatically [3] — exactly how you set them.

Watch ChecksTriggers when a check is created or updated.
Watch CriteriaTriggers when criteria are met in a specified service.
Watch EventsTriggers when an Xref webhook event occurs.
Watch Hiring AccountsTriggers when a new hiring account is created or updated.
Watch LogsTriggers when new logs are created.
Watch QuestionnairesTriggers when a new questionnaire is created.
Watch Reference TypesTriggers when a reference type is created or updated.
Watch UsersTriggers when a new user is created.
Get a CheckRetrieves details for a specific check.
Get a Check's LifecycleRetrieves lifecycle information for a check.
Get a CriterionRetrieves details for a specific criterion.
Get a LogRetrieves details for a specific log.
Get a PDF ReportRetrieves a report in PDF format.
Get a QuestionnaireRetrieves details for a specific questionnaire.
Get a Referee AttachmentRetrieves a specific referee attachment.
Get a ReportRetrieves a check report.
Get a UserRetrieves details for a specific user.
Get an EmployerRetrieves details for a specific employer.
Get CreditsRetrieves available credit information.
List ChecksRetrieves a list of all checks.
List Company DomainsRetrieves a list of company domains.
List CriteriaRetrieves a list of all criteria.
List EmployersRetrieves a list of all employers.
List Hiring AccountsRetrieves a list of hiring accounts for a company.
List LogsRetrieves a list of all logs.
List QuestionnairesRetrieves a list of all questionnaires.
List Referee AttachmentsRetrieves a list of referee attachments.
List Reference TypesRetrieves a list of reference types.
List UsersRetrieves a list of all users.
Retrieve a JSON ReportRetrieves a report in JSON format.
Add an Unusual Activity NoteAdds a note for unusual activity.
Add an Unusual Activity ResolutionAdds a resolution for unusual activity to a specified account or service.
Add Company DomainsAdds a list of domains to an existing company.
Cancel a CheckCancels an existing check.
Create a CheckCreates a new check in the specified account.
Create a Check with RefereesCreates a new check with pre-populated referees.
Create a CriterionCreates a new criterion in the system.
Create an EmployerCreates a new employer in the system.
Deactivate a CriterionDeactivates an existing criterion.
Deactivate a QuestionnaireDeactivates an existing questionnaire.
Delete Company DomainsDeletes a list of domains from a company.
Hide a CheckHides a check from visibility in the system.
Make an API CallPerforms an arbitrary authorized API request.
Register a CompanyRegisters a new company in the system.
Send a Replacement Reference EmailSends an email to replace a reference.
Send a Report to the Line ManagerSends a check report to the line manager.
Unlock a Xref StatusUnlocks the Xref status for a referee.
Validate a Check with RefereesValidates a new check with pre-populated referees.
Validate a RefereeValidates referee information provided.

How to integrate Xref in automation workflow?

3 simple steps to make your Xref connected with other apps in automation workflows on WEXTL. Up to 10 minutes integration set up.

STEP 1

Select Xref in workflow

Pick Xref app in the workflow builder [4] - just one click to select the app.

STEP 2

Connect Xref

When prompted, authorize access to Xref in WEXTL once. Xref credentials are encrypted and never shared with WEXTL. Authorization will be reused in any future API calls [3].

WEXTL wants to integrate with your Xref account. Approve?

STEP 3

Build a workflow

Build your workflow with Xref yourself or with WEXTL® AI Builder. Connect Xref to any available integrations [5], or use HTTP node to go beyond them.

Xref

How Xref connects and integrates with WEXTL

Save and approve your credentials once — WEXTL® stores authorization information encrypted and reuses the authentication whenever Xref app is called in workflows. That allows your hr automations to run without your attention, per defined schedule [7]. Explore documentation [6] for a detailed list of fields that Xref supports.

Full Xref API documentation

The following table illustrates what fields Xref integration require during authorization flow inside our workflow builder [4].

Demonstration of Xref connection step inside WEXTL Workflow Builder [4].

Field	Type	Help
Open API - API Key	password	Get your API key by requesting Open API access from Xref (your account must be onboarded for API). After approval, Xref will provide a Sandbox API Key (and production access as needed).

Connect Xref to popular apps on WEXTL

Enter a name of the other app you want to sync with Xref below. Click on selected app to explore integration options with Xref. If the app you search for is not available in WEXTL yet, you can use HTTP node [10] instead to integrate it directly.

Example automation with Xref integration

Select Watch Checks trigger from Xref - this will be a starting point in your automation. Whenever event happens in Xref, workflow will start [7] from Watch Checks node.

Search for Create a Check with Referees, connect it as the next step of integration sequence. You can use filters between Watch Checks and Create a Check with Referees, so only important data pass from Watch Checks to the next step. WEXTL gives you full control over the process of Xref automation. All parts of workflow are visible on the canvas [4].

Xref on WEXTL has 49 modules for combining hr automations. Explore Xref documentation for more.

Video slide demonstrates how Watch Checks and Create a Check with Referees nodes are used in Xref workflow.

Video slide demonstrates how Watch Checks and Create a Check with Referees [6] nodes are used in Xref workflow.

Frequently asked questions

Common questions about automating Xref in your workflows.

Xref has 8 triggers, including "Watch Checks", "Watch Criteria", and "Watch Events", and more. Triggers are start points of the workflow, and automations may start from them.

Integration has 41 actions, including "Get a Check", "Get a Check's Lifecycle", and "Get a Criterion", and more. Refer to our Xref Documentation for detailed inputs and outputs.

No. Most automations are built visually on the canvas by picking triggers, actions, and mapping fields. You can add custom JavaScript with Functions when advanced logic is needed — but our customers do that in rare cases [4].

Yes. Connections are authenticated per account, credentials are encrypted at rest, and you can enforce approvals and team-level access controls on any automation.

The Xref integration on WEXTL runs directly on its vendor public API — every field name, authentication method, and rate limit is controlled by Xref official API and covered in documentation [3]. WEXTL handles the request signing and pagination for you.

Absolutely. Where Xref provides native webhooks, you can use instant triggers to eliminate polling delay. For custom webhooks, WEXTL offers Custom Webhook node, so you can start automation whenever Xref or any other service sends event to webhook URL.

WEXTL is an AI-first visual canvas. The platform allows you to describe automation in plain text — and AI will wire nodes for Xref inside the workflow builder [4]. You can also use built-in workflow nodes (AI Agent, Human in the Loop, Condition, Aggregate Results) in pair with Xref modules to craft complex integration flows with branches, filtering, and conditional logic. There are absolutely no limits of what you can build.

References

List of sources used to gather information about the Xref integration.

Xref integration source code, module specs and credentials implementation.
Internal Xref integration documentation, structured input and output parameters, scopes, and authentication methods.
Official Xref vendor API documentation — used to verify field meanings, authentication flows, and anything our own specs don't fully capture.
WEXTL® Visual Workflow Builder, anonymized data from our technical support team.
WEXTL® Apps Library
WEXTL® Xref App Documentation
WEXTL® Workflow Scheduler
WEXTL® HTTP node documentation

Xref Integration

Supported triggers and actions for Xref integration