Navigate to Admin > API Keys https://app.ashbyhq.com/​admin/​api/keys and click +New in the top-right corner to open the overlay.

Enter a name (we suggest Jobref), leave Integration Partner empty, and click Create API Key to continue.

On the new key's panel, scroll to Endpoint Permissions and click Read All + Write All for the smoothest Jobref experience (or, if you'd rather lock it down, enable at minimum Jobs, Candidates, Interviews, and Hiring Process Metadata), then click Save and Continue.

Once the API key is generated, copy it and save it somewhere safe (you'll only see it once) - then head to Jobref → Settings → Integrations, choose Ashby, and click Connect to paste it in.

In Ashby, head to Admin and search for Interview Plans, then select it from the results - or jump straight there via app.ashbyhq.com/​admin/​interview/​interview-plans/​shared-plans.

Once you're in Interview Plans, select the one you're using (or plan to use) with Jobref.

A side panel will slide in from the right, showing the Active stages already configured.

Use the "Add active stage" input to add three more stages:

• Pending Jobref ICPF - triggers the AI interview invite the moment you drag a candidate into this stage.
• Failed Jobref ICPF - collects candidates who started the AI call but didn't finish it.
• Finished Jobref ICPF - shows candidates who completed the call and have a generated Ideal Candidate Profile Fit ready to review.