Skip to main content

How to configure Puck assessments in Ashby

Puck’s integration with Ashby Recruiting allows you to seamlessly add assessment to a job's plan.

Written by Melisa Cooper

🔌 Step 1: Initial Integration Setup

  1. Request the API Key from Puck (email support@careerpuck.com or click on the blue tray at the bottom righthand corner of your screen)

  2. Navigate to Ashby → Admin → Integrations → Puck.

    1. Paste the Puck API key into the Puck API Key field.

    2. Reselect Puck prod for Ashby API Key.

    3. Confirm the partner base URL: https://api.careerpuck.com/v1/webhooks/ashby/assessments

🎉 Success Check: Once complete, you'll see the verification banner: Your organization has the Puck integration enabled

📋 Step 2: Edit the Interview Plan

Add your AI assessment to any point in your existing recruiting pipeline.

  1. Open your target job in Ashby and go to the Interview Plan tab.

  2. Select the specific pipeline stage where you want to introduce the evaluation.

  3. Click + Add Activity, select the Puck integration

4. Choose your corresponding AI Interview from the Assessment Type dropdown list.

  • For information on creating AI Interviews in Puck, reference this article.

5. Click Add to lock the activity into the stage.

⚙️ Step 3: Enable Automations

Save your team manual clicks by ensuring candidates are invited the second they change stages.

  1. Click on Modify > Edit > Automation tab.

  2. Check the box labeled Automate on Stage Entry?

⚠️ Manual Fallback: If you choose to leave this untoggled, recruiters will need to manually open each candidate's profile and click Start Assessment followed by Start to trigger the invitation email.

Once enabled:

  • As soon as a candidate is moved into that stage, Ashby automatically sends the assessment.

  • A ⚡ lightning bolt icon will appear next to the stage in the interview plan, indicating it has an automated activity.

  • If you accidentally move a candidate into the stage, Ashby gives you a short window (about 15–20 seconds) to Undo the automation before it's sent.

✉️ Step 4: Send the Assessment Initiation

  1. If you don't enable automations, you'll have to manually click Start Assessment to each candidate.

2. Click Start to email the invitation to interview to the candidate.

📋 Tracking Status: A notification log (e.g., "[Assessment name] was sent to [Candidate] for [Role] by [User]") will appear in the candidate activity feed. This verifies that the invite email was sent out.

✅ Step 5: Completion Notification

  1. Once the candidate completes their AI interview, the assessment activity icon will automatically turn into a grey checkmark icon, and an Assessment Finished status note will appear under the activity feed.

🔍 Step 6: Review Results

  1. Expand the Puck Assessment Details section within the candidate's Ashby profile.

2. Click View in Puck.

3. You will be prompted to log in to your Puck dashboard, which will drop you directly into that candidate's specific interview results. Here, you can review the full text Transcript, generated Summary, and overall AI evaluation scores.

🔍 Step 7: Scoring

Scoring a candidate is in the hands of your recruiting team.

  1. Once you assign a score via the Puck Interview Scorecard, the score will send back to Ashby

    1. How to score in Puck

    2. Scoring view in Ashby

💡 Why It Matters

  • Single Source of Truth: Recruiters can initiate, track, and monitor AI assessments entirely inside Ashby without constant context-switching.

  • Real-Time Visibility: Instant visual status icons (like the completion checkmark) ensure your team knows exactly when an interview is ready for review.

  • Deep-Link Access: The "View in Puck" shortcut bypasses manual searching, taking you directly to transcripts and qualitative candidate summaries in one click.

Did this answer your question?