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: Integration

  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

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

📋 Step 2: Locate the Candidate

  1. Navigate into your target job within Ashby

  2. Click into the candidate you want to send the AI Interview to.

🛠️ Step 3: Assign the Assessment

  1. Click on + New Activity > Assessment.

2. Select Puck as your Assessment provider.

3. Click Select assessment type... and select the specific AI Interview you have set up in Puck.

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

4. Click Add Activity.

✉️ Step 4: Send the Assessment Initiation

  1. Now that the activity is added to the candidate profile, click Start Assessment

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. Scoring view 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?