Greenhouse - Assessments Setup Guide

This guide will help you configure Greenhouse Assessments integration using Knit.

Setup Instructions

Use the Create ATS Assessment Secrets API to generate the credentials required for configuring the Greenhouse Assessments integration. The response returns:
- secretKey
- baseUrl
Send the following details to [email protected]:

Field Value
API Key secretKey from Step 1
List Tests URL {baseUrl}/list_tests
Send Test URL {baseUrl}/send_test
Test Status URL {baseUrl}/test_status
Response Error URL {baseUrl}/response_error

Note: Replace {baseUrl} in all URLs with the baseUrl value obtained in Step 1.
For more details on the Greenhouse assessment workflow, refer the Greenhouse Assessments Workflow Guide.

Field	Value
API Key	`secretKey` from Step 1
List Tests URL	`{baseUrl}/list_tests`
Send Test URL	`{baseUrl}/send_test`
Test Status URL	`{baseUrl}/test_status`
Response Error URL	`{baseUrl}/response_error`

Supported Events - Greenhouse

record.new

The record.new event is triggered by Knit when Greenhouse sends an send_test request. This event is sent to the webhook URL registered for the ATS category.

Example Event Payload:

{
  "eventType": "record.new",
  "eventData": {
    "candidateAssessment": {
      "applicationId": "87456321",
      "assessmentPackage": {
        "description": null,
        "id": "pkg_9f3aK21",
        "metaData": null,
        "name": null,
        "type": null
      },
      "callbackUrl": "https://app.greenhouse.io/integrations/testing_partners/take_home_tests/12345",
      "candidate": {
        "emails": [
          {
            "email": "[email protected]",
            "type": "PERSONAL"
          }
        ],
        "firstName": "John",
        "id": "762198",
        "lastName": "Doe",
        "links": [
          "https://johndoe.dev/resume",
          "https://app.greenhouse.io/people/762198?application_id=87456321"
        ],
        "location": null,
        "phones": [
          {
            "phoneNumber": "+1-555-123-4567",
            "type": "NOT_SPECIFIED"
          }
        ]
      },
      "id": "ats_ass_PkX8gRRNx05D1cKvomNCW5",
      "jobId": null,
      "metaData": null,
      "originData": {
        "candidate": {
          "email": "[email protected]",
          "first_name": "John",
          "greenhouse_profile_url": "https://app.greenhouse.io/people/762198?application_id=87456321",
          "last_name": "Doe",
          "phone_number": "+1-555-123-4567",
          "preferred_name": "John",
          "resume_url": "https://johndoe.dev/resume"
        },
        "partner_test_id": "pkg_9f3aK21",
        "sent_by": "[email protected]",
        "url": "https://app.greenhouse.io/integrations/testing_partners/take_home_tests/12345"
      },
      "status": "NOT_SPECIFIED"
    }
  },
  "eventId": "evt-1982736450012",
  "recordId": "ats_ass_PkX8gRRNx05D1cKvomNCW5",
  "syncType": "real_time",
  "syncDataType": "ats_assessments",
  "syncJobId": "real_time",
  "syncRunId": "real_time_1982736441123",
  "triggeredAt": 1982736450012
}

Updated about 5 hours ago