> ## 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.

# SmartRecruiters

> Integrate Alex with SmartRecruiters

## Overview

Alex integrates with SmartRecruiters through **Kombo**, our unified integration provider. A single connection covers both directions:

* **Jobs and applications sync into Alex.** New job postings in SmartRecruiters 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 SmartRecruiters.** Your workflows can move applications between pipeline stages, post notes, upload the Alex interview report as an attachment, and add a link to the Alex report on the candidate's record.

## Key Features

### Automated Job Import

When a job is created in SmartRecruiters, 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 SmartRecruiters 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 SmartRecruiters job ID or its ref number. This option appears once the Kombo connection has finished its first sync.

### Automated Interview Invites

When a candidate applies in SmartRecruiters, 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 SmartRecruiters

Workflow action nodes let Alex update SmartRecruiters as candidates progress:

| Action                            | What it does                                                                          |
| --------------------------------- | ------------------------------------------------------------------------------------- |
| **Update Application Stage**      | Moves the application to a named pipeline stage (the stage list loads from your jobs) |
| **Create Application Note**       | Posts a note (e.g. the interview summary) on the application                          |
| **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 their SmartRecruiters record            |

**Filter by Application** and **Filter by Job** nodes can branch on any standard or custom SmartRecruiters field, so write-backs run only when your conditions match.

## Step 1: Connect SmartRecruiters via Kombo

1. In Alex, go to **Settings → Integrations** and select **SmartRecruiters**.
2. Click **Connect**. A Kombo-hosted connection page opens in a new tab with step-by-step instructions for generating the SmartRecruiters credentials it asks for (SmartRecruiters admin access required).
3. Complete the flow to authorize your SmartRecruiters account.
4. Back in Alex, the SmartRecruiters 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 SmartRecruiters fields populate the job title, description, client name, and location columns, and which jobs to import.
* **Application workflow** — add the **New Application** trigger as the entry point. Every new SmartRecruiters application enters the workflow here.
* **Write-backs** — add the SmartRecruiters action nodes (stage move, note, attachment, report link) wherever your workflow should update SmartRecruiters, e.g. after an interview completes or a decision is made.

## Sync Behavior

* Jobs and applications are polled every few minutes from Kombo's synced copy of your SmartRecruiters data, so a brand-new job or application typically appears in Alex within minutes.
* Alex stores SmartRecruiters' own identifiers, so a job imported manually and the same job arriving via auto-import deduplicate to a single record.
* Stage names in the **Update Application Stage** dropdown come from your open jobs' pipelines; the stage must exist on the application's job for the move to succeed.

## Troubleshooting

| Symptom                       | Likely cause                                                                                                                               |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| Jobs not importing            | Kombo connection not finished syncing (check the SmartRecruiters card in Settings), or the job workflow's filters exclude the job          |
| 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 a SmartRecruiters job ID or ref number, or the job hasn't reached Kombo's sync yet — retry after a few minutes |
| Stage move fails              | The configured stage name doesn't exist on the application's job pipeline                                                                  |