Setting Up the Ashby Integration

Modified on Tue, 19 May at 7:40 AM

Connect your Ashby ATS to Lavalier to sync candidates, job openings, and applications.

Before You Start

Admin permissions in Ashby to manage API credentials
Owner permissions in Lavalier

Step 1: Generate an API Key in Ashby

In Ashby, go to Integrations → API Keys in the left navigation bar
Click the New button in the top right
In the dialog, give the key a name you'll recognize later (e.g., "Lavalier Sync Key"). Leave the Partner field blank
Click Create API key
On the next screen, set the endpoint permissions to match the table below.
Click Save and Continue
On the final screen, copy the API key and save it somewhere safe — Ashby will only show it once

Required Permissions

Set the following endpoint permissions exactly. Lavalier needs read access across most modules to sync candidates and jobs, plus write access on Jobs and Candidates to push updates back to Ashby.

Module	Read	Write
Jobs	✅	✅
Candidates	✅	✅
Interviews	✅	—
Hiring Process Metadata	✅	—
Organization	✅	—
Offers	✅	—
Api Keys	✅	—
Approvals	✅	—
Notetaker	—	—
Reports	—	—

Under Other Permissions, leave all four checkboxes (confidential jobs and projects, non-offer private fields, updating application history, quality of hire data) unchecked.

Tip: You can optionally set Default Source to Platform: Lavalier so applications created via the integration are attributed to Lavalier in Ashby reporting.

Step 2: Connect Ashby to Lavalier

In Lavalier, go to Settings → Integrations
Find the Ashby card and click Connect
In the Connect Ashby dialog, paste your API Key
Click Connect

Lavalier verifies your key and starts syncing. You'll see Syncing. This might take several minutes… while it works, and Connected — Last synced [time] once it's done.

What Happens Next

Once connected, Lavalier syncs the following from Ashby:

Open positions and job posts (including the Employment Type, which becomes the role's Work Type in Lavalier)
Applications and interview pipeline stages
Candidates with active applications in progress
Candidate resumes (imported automatically to their profile)

Check the Integrations page to see sync status and progress.

Troubleshooting

Lavalier says "Unable to connect"

Double-check that you copied your credentials correctly with no extra spaces, and that you have admin permissions in Ashby.

Error: "Another ATS integration is currently active. Disconnect it first to connect Ashby."

Solution: You can only have one ATS connected to Lavalier at a time. Disconnect your existing ATS (Greenhouse or Ashby) from Settings → Integrations, then try again.

Some of my Ashby candidates aren't showing up in Lavalier

Solution: Lavalier only syncs candidates who have active applications past the pre-interview stages on open jobs. Candidates in earlier stages or on closed jobs won't appear.

I can't edit a candidate's title, company, or location

Solution: For candidates synced from Ashby, the title, company, and location fields are read-only in Lavalier because Ashby doesn't accept updates to these fields. To change them, update the candidate in Ashby and the changes will sync to Lavalier.

I can't edit a role's Work Type

Solution: For roles synced from Ashby, Work Type (Full-time, Part-time, Contract, Internship, Temporary) is managed by Ashby and reflects the Employment Type set on the job. To change it, update the Employment Type in Ashby and the change will sync to Lavalier.

I can't change the stage or status of an archived application

Solution: Ashby owns the archive state for applications. If an application is rejected or withdrawn in Ashby, you can't change its stage or move it back into the pipeline from Lavalier. Reopen the application in Ashby first — Lavalier will pick up the change on the next sync.

I see "Pending creation in Ashby" on a candidate

Solution: This candidate was created in Lavalier and is being synced to Ashby. While the badge is visible, the candidate can't be edited or deleted in Lavalier. Once the sync completes, the badge will update.