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:

Application updated
Candidate has been hired
Candidate has been unhired
Candidate has changed state
Candidate has submitted application
Candidate or prospect rejected
Candidate or prospect unrejected
Candidate or prospect updated
Delete application
Prospect created

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

Enable

Log in to your Greenhouse account.
Go to "Settings" page.
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.



Click on "WebHooks" link.



Do the same as in step 4.



Click on a drop-down menu "When".



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).



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



Choose Webhooks under ATS.



Copy the Endpoint URL to paste in Greenhouse.



Paste the Endpoint URL in Greenhouse.



Copy the Secret Key to paste in Greenhouse



Paste the Secret Key in Greenhouse.



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



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

Follow the steps 1-5 in Enable part.
Choose the webhook you want to edit and click the edit button.



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

Follow the steps 1-5 in Enable part.
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".

Was this article helpful?
Cancel
Thank you!