Below you can find step by step instructions on how to enable, edit, and disable webhooks from Greenhouse.

Requirement: The person who will enable and disable webhooks from Greenhouse must have permission "Site Admin" and developer permissions on managing and configuring webhooks.

Currently supported web hooks:

  1. Application updated

  2. Candidate has been hired

  3. Candidate has been unhired

  4. Candidate has changed state

  5. Candidate has submitted application

  6. Candidate or prospect rejected

  7. Candidate or prospect unrejected

  8. Candidate or prospect updated

  9. Delete application

  10. Prospect created

Do not worry if you enabled other webhooks. They will not cause any errors or make any changes in Teamable.

Enable

  1. Log in to your Greenhouse account.

  2. Go to "Settings" page. 

  3. Go to "Dev Center". If you are not able to find the "Dev Center" link, it means that you do not have developer permissions. You can view your permissions in Greenhouse Account Settings.  

4. Click on "WebHooks" link. 

5. Do the same as in step 4. 

6. Click on a drop-down menu "When".

7. Choose the event on which you want the webhook to be triggered. (You can create more than one webhook by following the same steps described). 

8. Log in to your Teamable site.
9. Click on the Admin Panel. 

10. Choose Webhooks under ATS. 

11. Copy the Endpoint URL to paste in Greenhouse. 

12. Paste the Endpoint URL in Greenhouse. 

13. Copy the Secret Key to paste in Greenhouse

14. Paste the Secret Key in Greenhouse. 

15. Add error recipient email - email address to which an email with the information of failure of sending a webhook will be sent (optional). 

16. Leave the other fields empty and click on the "Create Webhook" button. If everything is done correctly, a message like this will appear. 

Otherwise, you will get an error message like this but the webhook will be created with status "Disabled?" = "Yes". 

In the above screenshot, for example, the URL was typed incorrectly. 

You can create webhooks on multiple events, following the same steps

Edit

  1. Follow the steps 1-5 in Enable part.

  2. Choose the webhook you want to edit and click the edit button. 

3. Make the changes you wish and click the "Update Webhook" button. 

 If everything is done correctly, a message like this will appear. 

Otherwise, you will get an error message but your changes will be saved. The status "Disabled?" will be set to "Yes" 

Disable

  1. Follow the steps 1-5 in Enable part.

  2. Choose the webhook you want to delete from the "Edit WebHook" list and click the delete button. The webhook will disappear from the "Edit WebHook" list. 

Or follow the steps in Edit part and change the "Disabled?" status to "Yes".

Did this answer your question?