Setting Up Web Hooks in Greenhouse

Set up web hooks in Greenhouse so that data gets synced to TalentWall instantly.

You must be a TalentWall admin and have developer permissions in Greenhouse to set up the web hooks.

Please follow the instructions below based on which TalentWall platform your org uses to login:


For orgs that login to app.talentwall.io

In TalentWall:

  1. Go to Account settings from the blue circle in the top right.
  2. Then select the Integrations tab.
  3. Scroll down to where it says Greenhouse Web Hook Configuration.
    You'll want to copy and paste these Web hook links into Greenhouse.

deletion web hooks

"Never seen" indicates new web hooks that haven't been fired by Greenhouse yet.

In Greenhouse:

  1. Go to Dev Center > Web Hooks > Web Hooks (again)

    GH web hooks

2.    Under "Create a New Web Hook", select the web hook you want to add under "When."

3.    Name the web hook accordingly to know it's for TalentWall and for the intended action:
greenhouse web hook page

4.    Paste the corresponding Endpoint URL from TalentWall. The endpoint URL is the URL from the integration settings in TalentWall. There is a unique URL that should correspond with the name you selected from the "When" dropdown in Greenhouse.

5.    Copy and paste the Secret key from TalentWall. The secret key can be found from Account Settings > Integrations and is the first field under the section called Greenhouse Webhook Configuration.

6.    The Error recipient email is optional, but make sure that the web hook is not disabled:

enable web hook

6.   Click on the blue button that says "Create Web hook."


Then do this manually again for each web hook below.

  • Application updated
  • Candidate has submitted application
  • Candidate has changed stage
  • Candidate or prospect updated
  • Candidate has been hired
  • Candidate or prospect rejected
  • Job deleted
  • Job updated
  • Job created
  • Merged candidate
  • Delete application
  • Interview deleted
  • Delete candidate
  • Department deleted
  • Job interview stage deleted
  • Offer deleted
  • Office deleted
  • Scorecard deleted

For orgs that login to org.crosschq.com

In Crosschq:

  1. From your homepage, navigate to the TalentWall app.
  2. Click on your email at the top-right corner and select Account Settings.
  3. Toggle to the ATS Connection tab.
  4. Scroll to the section called Greenhouse Webhook Configuration. This section contains a web hook secret and a web hook URL. Both will be inputted in Greenhouse to create each web hook event.

In Greenhouse:

  1. Go to Dev Center > Web Hooks > Web Hooks (again)

    GH web hooks

2.    Under "Create a New Web Hook", select the web hook you want to add under "When."

3.    Name the web hook accordingly to know it's for TalentWall and for the intended action:
greenhouse web hook page
A web hook will need to be created for each of the following actions:

  • Application updated
  • Candidate has submitted application
  • Candidate has changed stage
  • Candidate or prospect updated
  • Candidate has been hired
  • Candidate or prospect rejected
  • Job deleted
  • Job updated
  • Job created
  • Merged candidate
  • Delete application
  • Interview deleted
  • Delete candidate
  • Department deleted
  • Job interview stage deleted
  • Offer deleted
  • Office deleted
  • Scorecard deleted

4.    Paste the corresponding Endpoint URL from TalentWall, which is the URL from the Greenhouse Webhook Configuration section.

5.    Copy and paste the Secret key from TalentWall, which is the web hook secret from the Greenhouse Webhook Configuration section.

6.    The Error recipient email is optional, but make sure that the web hook is not disabled:

enable web hook

6.   Click on the blue button that says "Create Web hook." Then, do this again for each of the web hooks listed in step 3. The same web hook URL and web hook secret from TalentWall will be used to create each web hook event in Greenhouse. The only difference is the event that you will be selecting from the Greenhouse dropdown menu.