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

# ATS Integration

> Sync candidates from your existing ATS into TalentUnveiled

If you already manage roles and applications in an Applicant Tracking System (ATS), TalentUnveiled can pull candidates into the interview workflow automatically. This page walks through the setup and explains exactly when candidates start arriving.

## How It Works

1. **Connect your ATS.** Contact your TalentUnveiled representative or email [contact@talentunveiled.com](mailto:contact@talentunveiled.com) to receive a setup link for your ATS. This step only needs to happen once per account.

2. **Create the job in your ATS.** Open your ATS and create the role as you normally would.

3. **Configure the job in TalentUnveiled.** The job appears in the TU portal as a draft, and your hiring team is emailed to review it. Open it and set up your interview questions, scoring criteria, language, and any other settings.

4. **Activate the job.** When everything is configured the way you want it, change the job's status from Draft to Active.

5. **Add candidates in your ATS.** Any candidate added to the activated job in your ATS now flows into TU automatically — the interview workflow starts as soon as they're synced.

## When Candidates Are Imported

The moment you first set a job to **Active** in TalentUnveiled is the import cutoff:

* Candidates added in your ATS at or after that moment → imported into TU.
* Candidates added before that moment → not imported. This avoids surprising you with a wave of backfilled candidates from before the job was ready.

Syncing always moves forward from the moment it's switched on. If syncing is enabled for your account (or paused and later re-enabled), candidates from before that moment are not imported — see [Importing Historical Candidates](#importing-historical-candidates) if you need them.

<Warning>
  A candidate must have a valid phone number in your ATS to be imported. Interviews run over the phone or the web with phone verification, and TalentUnveiled identifies each candidate by their phone number — candidates without one are skipped during sync.
</Warning>

## Status Updates from Your ATS

Once a candidate is in TalentUnveiled, hiring decisions made in your ATS carry over:

* Marking a candidate **hired** or **rejected** in your ATS updates their application in TU to match.
* Intermediate stage moves in your ATS never overwrite the progress a candidate has already made in TU — the interview pipeline in TU stays the source of truth until you make a final decision.

## Importing Historical Candidates

Need candidates from before the import cutoff — for example, everyone who applied to a role before you connected TalentUnveiled? The TU team can run a one-time historical import for a specific job on request, optionally narrowed by application date, hiring outcome, or pipeline stage. You'll receive a preview of exactly who would be imported before anything happens.

Contact [contact@talentunveiled.com](mailto:contact@talentunveiled.com) to request a historical import.

## Jobs Closed in Your ATS

If a job is already closed or archived in your ATS the first time TalentUnveiled sees it, it is **not** imported — there's nothing to review or interview for, so it never appears in the TU portal.

If you reopen that job in your ATS later, the next sync imports it fresh as a **Draft**, and the normal review-and-activate flow above applies.