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

# ATS integration

> Push candidates into intervyo.ai and pull scorecards back into your ATS — Greenhouse, Lever, Bullhorn, or custom.

intervyo.ai supports two integration shapes for ATS connectors:

<CardGroup cols={2}>
  <Card title="Native connectors" icon="plug">
    Greenhouse, Lever, Bullhorn, Loxo, Vincere, SmartRecruiters. OAuth
    install, field mapping in the UI, bi-directional sync.
  </Card>

  <Card title="Webhook + REST API" icon="webhook">
    For any ATS or in-house tool. Subscribe to `session.scored`; push
    scorecards into your ATS via its own API.
  </Card>
</CardGroup>

## Native connector flow

<Steps>
  <Step title="Install the connector">
    **Settings → Integrations** → pick your ATS → install via OAuth.
  </Step>

  <Step title="Map fields">
    Drag-and-drop UI to map intervyo.ai's scorecard dimensions to your
    ATS's custom fields. No code, no support tickets.
  </Step>

  <Step title="Sync runs automatically">
    Every completed session pushes its scorecard + transcript link +
    recording link into the candidate's ATS record. Candidate changes in
    the ATS reflect here on the next sync window.
  </Step>
</Steps>

## Custom ATS via webhooks

If your ATS isn't on the native list:

1. Register a [webhook endpoint](/en/concepts/webhooks) subscribed to
   `session.scored`
2. On each event, your backend pulls the session payload and writes the
   fields you care about into the candidate's record in your ATS

The session payload includes the candidate's email + external ID (if you
set one on creation), so matching to your ATS's candidate record is a
one-line lookup.

<Tip>
  Set `external_id` on participants and sessions when you create them via
  API. The platform echoes that ID back on every webhook so you can
  identify the matching record in your ATS without an extra lookup.
</Tip>

<Note>
  This page is a stub. For the full per-ATS field mapping reference and
  OAuth scopes,
  [contact hi@intervyo.ai](mailto:hi@intervyo.ai).
</Note>