ATS

Connect your ATS once. From then on, everyone in your ATS is kept off outreach, each ATS job can be linked to a Superposition job, and the candidates you approve here are added to your ATS with their résumé, interviews and scorecards.

Settings → Integrations → ATS (admins only). Provider setup pages appear here as each provider is certified; Ashby is first.

ConnectCopy Anchor Link

Click Add ATS, pick your provider, and sign in on the provider's own screen. Superposition never sees or stores your ATS credentials.

What happens next:

• Protection starts at once. Every person with recent activity in your ATS (by email or LinkedIn) is kept off outreach at your company, whether or not you link any job. Recent means inside the window you set on the connection: 180 days by default, 0 to 730. An application, a stage change, a rejection, a hire, an interview or a note all count as activity. Someone whose last activity is older than the window can be contacted again, rejected or hired alike. This does not archive or move anyone you are already talking to; it stops new outreach only.
• People you sync from Superposition are the exception. A candidate who replied, booked an interview and was then synced to your ATS stays reachable through Superposition; syncing them never silences that conversation.
• The first sync takes up to 24 hours. Your jobs arrive first, then candidates. Outreach at your company is paused while that runs so nobody slips through before their record arrives. You get an email when your jobs are ready to link. If the sync overruns, an admin can extend the pause from the connection card, up to three times.
• Deleting someone from your ATS counts as activity. They stay off outreach for the full window after the deletion, so a recent removal is never followed by a cold email.
• Disconnecting counts as activity for everyone present at the time, so they stay off outreach for the window and then lapse. Nothing is deleted from your ATS.

MappingCopy Anchor Link

Open the Job linking tab. Each open ATS job shows whether it is linked; a suggested Superposition job is pinned when the titles match.

• Link: pick the Superposition job and confirm. The confirm step tells you, from data we already hold, how many applicants are already your candidates, how many we will look up, and how many wait under Needs attention. The link applies right away.
• Create in Superposition: makes a draft job from the ATS description, links it, and opens the usual setup. The same option is on the job creation page.
• Add candidates to your ATS when: per linked job, choose the moment a candidate is added automatically: first interview booked (default), when you approve them, when they reply interested, or only when someone syncs them by hand.
• Stage links: per linked job, what each of the ATS job's interview stages means in Superposition (Awaiting review, Interviewing, Offer, Hired). Several ATS stages can mean the same thing: Workable's "Sourced" and "Applied" are both awaiting review. We suggest the links by name when you link the job; when a stage we need is still uncovered the dialog opens so you can pick it, and a linked job with no stage links is flagged on the connection card. The links decide where a person enters your ATS (the first linked stage) and, for the applications Superposition created, keep the stage in step both ways.

The same controls are on each job's Settings page under ATS.

ReviewCopy Anchor Link

The Needs attention tab lists people synced from your ATS who have no email and no LinkedIn profile, so we cannot be certain to keep them off outreach. Add an email and the person is protected at once and matched to any profile we already have. Nothing else is asked of you; the list is a disclaimer, not a to-do.

PushCopy Anchor Link

Candidates reach your ATS on the trigger you chose per job, or from the Sync to ATS control on a candidate's page. Each push creates the candidate and an application on the linked job (only the application when they are already in your ATS), attaches the résumé as a file, and enters them at the linked stage. Afterwards, for the applications Superposition created:

• interviews booked in Superposition are logged as scheduled interviews, and cancellations as notes;
• the Signal post-interview summary and each interviewer's scorecard are added as notes;
• a stage move on either side is mirrored through the stage links; a rejection or hire in your ATS moves the candidate here.

Each of those can be turned off per connection. A provider that does not accept interviews or notes from integrations shows that instead of the toggle.

HistoryCopy Anchor Link

The Sync history tab shows every run: when it ran, how many people and jobs were seen, how many are kept off outreach, and whether anything is retrying. Connection issues that need your attention (an expired login, a missing permission) show on the connection card with a Reconnect action.

Automate itCopy Anchor Link

Everything above is also on the API under /api/v1/ats with the ats:read and ats:write scopes; the connect, mapping and settings calls additionally need a client-admin key. See the API reference.

# Start a sync and poll the run
curl -X POST https://app.superposition.ai/api/v1/ats/connections/CONNECTION_ID/sync \
  -H "Authorization: Bearer $SUPERPOSITION_API_KEY"
curl https://app.superposition.ai/api/v1/ats/connections/CONNECTION_ID/runs \
  -H "Authorization: Bearer $SUPERPOSITION_API_KEY"

# Preview, then map an ATS job to a Superposition job
curl -X POST https://app.superposition.ai/api/v1/ats/job-links/LINK_ID/preview \
  -H "Authorization: Bearer $SUPERPOSITION_API_KEY"
curl -X PATCH https://app.superposition.ai/api/v1/ats/job-links/LINK_ID \
  -H "Authorization: Bearer $SUPERPOSITION_API_KEY" -H "Content-Type: application/json" \
  -d '{"jobId":"JOB_ID","pushTrigger":"client_approved"}'

# Push a candidate; a repeat returns the current presence instead of a second create
curl -X POST https://app.superposition.ai/api/v1/candidates/CANDIDATE_ID/ats-push \
  -H "Authorization: Bearer $SUPERPOSITION_API_KEY" -H "Content-Type: application/json" \
  -d '{"stageId":"STAGE_ID"}'

PortalCopy Anchor Link

Teams without a supported ATS can keep using the submission portal: turn it on under the same page and paste your portal's submission URL. The URL must be a public HTTPS address (it is fetched by our servers), and candidates are submitted once per role, on stage entry or on the first booked interview. A job linked to an ATS above never uses the portal.

Next stepsCopy Anchor Link

• Pipeline · Interview scheduling
• Other connections: Integrations