Integration Guide

Connect Assessly with Zapier

Automate your hiring workflow by connecting Assessly with 5,000+ apps. No coding required - just configure and go.

Popular Automation Recipes

Slack Notification

Get notified in Slack when a candidate completes an assessment

submission.completed
Send channel message

Google Sheets

Log all submissions to a spreadsheet for easy tracking

submission.completed
Create spreadsheet row

Email Notification

Send personalized emails to candidates or hiring managers

submission.completed
Send email via Gmail

CRM Integration

Sync candidate data to HubSpot, Salesforce, or Pipedrive

submission.completed
Create/update contact

Task Management

Create Trello cards or Asana tasks for review workflows

submission.created
Create card/task

Calendar Events

Schedule interviews when candidates score above threshold

submission.completed
Create calendar event

Setup Guide

1

Create a Zap in Zapier

Log into Zapier and click "Create Zap". Choose "Webhooks by Zapier" as your trigger app, then select "Catch Hook" as the trigger event.

2

Copy Your Webhook URL

Zapier will generate a unique webhook URL. Copy this URL - you'll need it in the next step.

3

Add Webhook in Assessly

Go to Settings → Integrations in Assessly. Click "Create Webhook" and paste your Zapier webhook URL. Select which events to send (e.g., submission.completed).

4

Test Your Connection

Click "Send Test" in Assessly to send a sample payload. In Zapier, click "Test trigger" to receive the data and see all available fields.

5

Configure Your Action

Choose what happens when a submission is received. Map the fields from Assessly (candidate name, email, score, etc.) to your destination app.

6

Turn On Your Zap

Review your Zap and turn it on. You're now connected! Every matching event in Assessly will automatically trigger your workflow.

Available Events

submission.created

Triggered when a candidate starts an assessment

Use cases: Track assessment starts, notify hiring managers

submission.completed

Triggered when a candidate submits their assessment

Use cases: Log results, send notifications, update CRM

submission.updated

Triggered when a submission is reviewed or scored

Use cases: Sync status updates, trigger next steps

Sample Payload

When an event occurs, Assessly sends a JSON payload with all the relevant data. Here's what you'll receive in Zapier:

json
{
"event": "submission.completed",
"timestamp": "2025-01-15T10:30:00Z",
"submission_id": "sub_abc123",
"assessment_id": "asmt_xyz789",
"assessment_title": "Frontend Developer Test",
"candidate_name": "John Doe",
"candidate_email": "john.doe@example.com",
"candidate_phone": "+1 555-123-4567",
"status": "completed",
"ai_score": 85,
"ai_summary": "Strong technical skills with excellent problem-solving...",
"grade": "A",
"time_spent_seconds": 2400,
"started_at": "2025-01-15T09:50:00Z",
"completed_at": "2025-01-15T10:30:00Z",
"public_url": "https://assessly.app/submission/sub_abc123",
"company_id": "comp_xyz123",
"total_questions": 10,
"answered_questions": 10
}

Pro Tip: Field Mapping

All fields are flattened for easy mapping in Zapier. Use candidate_email to send follow-up emails, ai_score to filter high performers, and assessment_title to organize your workflows.

Getting Full Response Details

Webhook payloads include summary information like candidate details, scores, and response counts. For the complete submission including all question responses, we recommend using the Assessly API.

Why not include responses in webhooks?

  • Fast delivery: Smaller payloads mean faster webhook processing
  • Easy field mapping: Flat structure works seamlessly with Zapier
  • Flexible access: Fetch full details only when needed via API

Using the API to Get Full Details

  1. 1. Create an API key in Settings → Integrations
  2. 2. In your Zap, add a "Webhooks by Zapier" action step
  3. 3. Use the submission_id from the webhook
  4. 4. Make a GET request to: https://assessly.app/api/v1/submissions/{submission_id}
  5. 5. Add header: Authorization: Bearer YOUR_API_KEY

Example Zap Flow:

TriggerCatch webhook from Assessly
ActionGET request to API for full submission
ActionSend to Google Sheets / Slack / your app

Security & Verification

Every webhook from Assessly includes an HMAC-SHA256 signature in the X-Webhook-Signature header. While Zapier's "Webhooks by Zapier" handles this automatically, you can verify the signature if using a custom endpoint.

Headers Included:

  • X-Webhook-Signature - HMAC-SHA256 signature
  • X-Webhook-Event - Event type (e.g., submission.completed)
  • X-Webhook-Delivery-ID - Unique delivery identifier

Need Help?

We're here to help

Having trouble setting up your Zapier integration? Our team is happy to help you get connected.

Zapier Integration - Connect Assessly with 5000+ Apps | Assessly