> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alex.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ADP Workforce Now

> Integrate Alex with ADP Workforce Now

## Overview

Alex integrates with ADP Workforce Now Recruitment through **Kombo**, our unified integration provider. A single connection covers:

* **Jobs and applications sync into Alex.** New job requisitions in ADP automatically appear in Alex, where your job workflow configures them into interviews; new applications enter your application workflow (for example, automatically inviting each applicant to an interview).
* **Interview results sync back to ADP.** Your workflows can attach the Alex interview report PDF to the application and add a link to the Alex report on the application.

<Note>
  ADP Workforce Now's integration API does not support moving applications between recruiting stages, rejecting
  applications, or posting notes. Recruiters act on Alex results inside ADP — the report link and attached PDF put
  those results directly on the application.
</Note>

## Key Features

### Automated Job Import

When a job requisition is created in ADP, Alex imports it and runs your job workflow — generating an interview template from the job's title and description. Use the **New Job from ATS** trigger node in your job workflow to configure which ADP fields (including custom fields) populate the job title, description, and jobs-list columns, and use **Filter by Job** nodes to route different kinds of jobs to different interview templates.

### Manual Job Import

You can also import a single job on demand: when creating a job in Alex, choose **Import from ATS** and paste the ADP requisition ID. This option appears once the Kombo connection has finished its first sync.

### Automated Interview Invites

When a candidate applies in ADP, Alex picks up the application, creates the candidate, and fires the **New Application** trigger in your application workflow — typically inviting the candidate to an interview by email or SMS.

### Write-Backs to ADP

Workflow action nodes let Alex update ADP as candidates progress:

| Action                            | What it does                                                                                                                   |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **Upload Application Attachment** | Attaches the Alex interview or verification report PDF to the application                                                      |
| **Add Alex Report Link**          | Adds a link to the candidate's Alex report on the application, and sets the application's assessment status to the link's text |

<Tip>
  ADP stores the report link's text as the application's **assessment status**, so what you type is what recruiters read
  in ADP. The field accepts Alex variables — set it to `Alex Interview: {{overall_score}}` and every application carries
  its interview score without anyone opening the report.
</Tip>

**Filter by Application** and **Filter by Job** nodes can branch on any standard or custom ADP field — including the application's current stage — so write-backs run only when your conditions match.

<Note>
  ADP does not provide candidate resumes through the integration, so **resume-fit scoring does not apply to
  applications that arrive from ADP**. Resume-fit works for candidates added in Alex through **Upload Resumes**, where
  the resume is in place before the interview is set up. A resume supplied later — by the candidate on the pre-interview
  screen, for example — arrives after the point where scoring runs, so it generally will not produce a score.
</Note>

## Before You Start

API access to ADP Workforce Now is a **paid add-on from ADP**, not part of a standard Workforce Now subscription. Purchasing it involves a statement of work with ADP and an assigned ADP representative. Until it is active on your account, the connection flow in Step 1 cannot complete — no Alex configuration works around this. Start with your ADP representative, and talk to your Alex account team if you are unsure whether your account already includes it.

## Step 1: Connect ADP via Kombo

1. In Alex, go to **Settings → Integrations** and select **ADP Workforce Now**.
2. Click **Connect**. A Kombo-hosted connection page opens in a new tab with step-by-step instructions for authorizing the connection against your ADP Workforce Now account.
3. Back in Alex, the ADP card shows **Syncing…** while Kombo runs its first sync, then **Connected**. Job and application sync begins automatically once the first sync completes.

<Note>
  If the card shows **Needs attention**, the connection requires re-authorization — repeat the Connect flow or contact
  your Alex account team.
</Note>

## Step 2: Configure Your Workflows

* **Job workflow** — add the **New Job from ATS** trigger. Its editor lets you choose which ADP fields populate the job title, description, and location columns, and which jobs to import.
* **Application workflow** — add the **New Application** trigger as the entry point. Every new ADP application enters the workflow here.
* **Write-backs** — add the ADP action nodes (attachment, report link) wherever your workflow should update ADP, e.g. after an interview completes.

## Sync Behavior

* Kombo re-reads your full ADP account about every 5 minutes — ADP offers no incremental sync — and Alex polls Kombo's synced copy, so a new requisition or application usually reaches Alex within roughly that window. Very large ADP accounts can run longer than the interval, which stretches the delay.
* Alex stores ADP's own identifiers, so a job imported manually and the same job arriving via auto-import deduplicate to a single record.
* Stage changes made in ADP flow into Alex and can update interview decisions via your ATS sync mappings (Settings → ATS Sync), in the ADP → Alex direction.

## Troubleshooting

| Symptom                          | Likely cause                                                                                                                      |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Jobs not importing               | Kombo connection not finished syncing (check the ADP card in Settings), or the job workflow's filters exclude the requisition     |
| Candidates not invited           | The application workflow has no **New Application** trigger, or the application's job hasn't been imported into Alex              |
| Import from ATS finds nothing    | The pasted ID doesn't match an ADP requisition, or the requisition hasn't reached Kombo's sync yet — retry after a few minutes    |
| No resume on the candidate       | Expected — ADP doesn't provide resumes through the integration                                                                    |
| Resume fit shows "Not evaluated" | Expected for ADP-sourced applications — there is no resume to score. Add candidates via **Upload Resumes** if you need resume fit |