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

# Spark Hire Recruit

> Integrate Alex with Spark Hire Recruit

## Overview

Alex integrates with Spark Hire Recruit (formerly Comeet) through **Kombo**, our unified integration provider. A single connection covers:

* **Jobs and applications sync into Alex.** New jobs in Spark Hire Recruit 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 as notes.** Your workflows can post a note on the application, such as the interview summary and score.

> [!NOTE]
>
> Through Kombo, Spark Hire Recruit does not support moving applications between stages, rejecting applications,
> uploading files, or adding a report link field. Recruiters act on Alex results inside Spark Hire Recruit, using the
> note Alex posts on the application.

## Key Features

### Automated Job Import

When a job is created in Spark Hire Recruit, 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 choose which Spark Hire Recruit 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 Spark Hire Recruit job ID. This option appears once the Kombo connection has finished its first sync.

### Automated Interview Invites

When a candidate applies in Spark Hire Recruit, 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.

Resumes attached to the application come across with the candidate, so resume-fit scoring works for Spark Hire Recruit applications. Other files, such as cover letters, do not sync.

### Write-Backs to Spark Hire Recruit

| Action | What it does |
| - | - |
| **Create Application Note** | Posts a note (e.g. the interview summary) on the application |

**Filter by Application**, **Filter by Job** and **Filter by Candidate** nodes can branch on any standard or custom Spark Hire Recruit field, including the application's current stage and the candidate's other applications, so the note is posted only when your conditions match.

### Reacting to Changes in Spark Hire Recruit

The **Application Updated** trigger runs a workflow when an application already in Alex changes in Spark Hire Recruit. For example, when a recruiter moves a candidate to a new stage, a **Filter by Application** node on that stage can send the candidate their interview invite.

## Step 1: Connect Spark Hire Recruit via Kombo

Connecting needs a Spark Hire Recruit user with the **Admin** or **Owner** role.

1. In Alex, go to **Settings → Integrations** and select **Spark Hire Recruit**.
2. Click **Connect**. A Kombo-hosted connection page opens in a new tab and asks for a Spark Hire Recruit API key.
3. In Spark Hire Recruit, go to **Apps**, search for **Kombo**, select its tile, and click **Continue to setup**.
4. Choose which positions Alex can access, then click **Copy API key**.
5. Paste the key into the Kombo connection page and finish the steps there. Then return to Spark Hire Recruit and click **Activate**.
6. Back in Alex, the Spark Hire Recruit card shows **Syncing…** while Kombo runs its first sync, then **Connected**. Job and application sync begins automatically once the first sync completes.

> [!WARNING]
>
> Alex only sees the positions you share in step 4. Choosing **Published positions only** or **Non-discreet
> positions** leaves every other position, and its applicants, out of Alex.

> [!NOTE]
>
> Refreshing the API key in Spark Hire Recruit (**Apps → Kombo → Setup → Refresh Key**) disconnects Alex. The card
> then shows **Needs attention**: repeat the Connect flow with the new key, or contact your Alex account team.

## Step 2: Configure Your Workflows

* **Job workflow**: add the **New Job from ATS** trigger. Its editor lets you choose which Spark Hire Recruit 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 Spark Hire Recruit application enters the workflow here. Add **Application Updated** to act when a recruiter changes an application in Spark Hire Recruit.
* **Write-backs**: add a **Create Application Note** node wherever your workflow should report back to Spark Hire Recruit, e.g. after an interview completes.

## Sync Behavior

* Alex reads Kombo's synced copy of your Spark Hire Recruit data. Changes reach Alex after Kombo's next scheduled sync, not instantly.
* Alex stores Spark Hire Recruit'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 Spark Hire Recruit flow into Alex and can update interview decisions through your ATS sync mappings (**Settings → ATS Sync**), in the Spark Hire Recruit → Alex direction only.
* Changes to an imported job's fields reach Alex through the job mappings in **Settings → ATS Sync**.

## Troubleshooting

| Symptom | Likely cause |
| - | - |
| Jobs not importing | Kombo connection not finished syncing (check the Spark Hire Recruit card in Settings), the position isn't shared with Kombo, or the job workflow's filters exclude it |
| 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 Spark Hire Recruit job, or the job hasn't reached Kombo's sync yet; retry after a few minutes |
| Card shows Needs attention | The API key was refreshed or the Kombo app was deactivated in Spark Hire Recruit; repeat the Connect flow |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.