Skip to main content

Setting up webhook for candidate and application deletions

Understand how to manage or remove application and candidate webhooks in Greenhouse for cleaner data handling.

Shanie Grancioso avatar
Written by Shanie Grancioso
Updated over a week ago

Greenhouse Recruiting allows you to delete an application or candidate. However, if you also need to remove this data from Sapia.ai—for example, to comply with privacy regulations such as GDPR—you must manually configure a webhook to trigger the deletion.

⚠️ Important: Deleting data from Sapia is permanent and cannot be undone

  1. Navigate to the Dev Center in your Greenhouse configuration settings.

  2. Select Webhooks > Webhooks.

  3. Add a new webhook with the following details:

    • Name this Webhook:
      Use a clear name such as Sapia Delete Application

    • When: Delete Application

    • Endpoint URL: enter the correct endpoint URL provided by Sapia.ai

    • Secret Key: use the Harvest API Key generated/used for Sapia.ai

    • Enter recipient email (Optional): Enter an email address to receive notifications in case of webhook failures.

  4. Click Advanced Settings…

  5. Under Basic Authorization Credentials:

    • Username: enter the Sapia API key that was provided

    • Password: leave blank.

  6. Set Maximum Attempts to 6.

  7. Ensure Deactivated? is set to No.

  8. Click Create Web Hook.

  9. Repeat steps 3-8 to create a second webhook (Delete Candidate) with the following change:

    • Name this Webhook:
      Use a clear name such as Sapia Delete Candidate

    • When: Delete Candidate

    • (All other settings remain the same as the first webhook)

Did this answer your question?