Greenhouse Real Time Events

List of Events Supported by Greenhouse

Subscribe to Greenhouse Real Time Events

Step 1: Subscribe to events and Get the Webhook URL

To subscribe to real time events in Greenhouse, you can use the Subscribe to Real Time Events API. A cURL for the same would look like:

curl --location 'https://api.getknit.dev/v1.0/events.subscribe' \
--header 'X-Knit-Integration-Id: <YOUR_INTEGRATION_ID>' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--data '{
    "events": [
        "ats_applications_new",
        "ats_applications_modified",
        "ats_applications_deleted",
        "ats_jobs_new",
      	"ats_jobs_modified",
      	"ats_jobs_deleted"
    ]
}'

The response for this would look like the following:

{
  "success": true,
  "data": {
    "webhookUrl": "https://workflows.getknit.dev/webhook/wt_3xvamZYMn6Q7bUzZtBz",
    "metaData": {
      "webhookToken": "greenhouseWebhookToken_VvTGKui1DIXTnrfftn"
    }
  }
}

This webhook URL and webhook Token needs to be configured in greenhouse dashboard.

Step 2: Configure Webhooks in Greenhouse Dashboard

Your customer should follow these steps to set up the webhook in Greenhouse:

1. Log in to Greenhouse Recruiting
   Access the Greenhouse dashboard using your credentials.

2. Navigate to the Dev Center
   Click the Configure icon on the top navigation bar, then select Dev Center from the left-hand menu.

3. Access Web Hooks
   In the Dev Center section, click on Web Hooks.

4. Create a New Webhook
   Click Web Hooks again to begin creating a new webhook.

5. Fill in the Webhook Details

   • Name: Provide a descriptive name (e.g., Candidate Stage Changed Knit Webhook)
   • When: Choose the specific event that should trigger the webhook (e.g., Candidate has changed stage)
   • Endpoint URL: Paste the webhookUrl shared by Knit
   • Secret Key: Paste the webhookToken shared by Knit
   • Error Recipient Email: Keep it empty for now.

6. Save the Webhook
   Click Create Webhook. A test ping will be sent to verify the connection.

Refer the loom video for setting webhooks in greenhouse dashboard - Greenhouse Webhook Setup