When a candidate is marked as hired, Greenhouse Recruiting can export all relevant data about the new hire using a webhook. This export will include the candidate, job, and offer details, as well as any custom fields configured in Greenhouse Recruiting. You can view a sample candidate hired webhook payload here: Developer Resources > Web Hooks > Candidate hired.
Tip: The hired candidate export can be received by your HRIS platform and transformed so that the data can be used to create a pre-hire and employee record in your HRIS. Information about the position can also be included if the position was created in Greenhouse Recruiting. Most of this integration work is done in the HRIS platform to build the listener workflow that receives the data and transforms it into your HRIS.
Create a candidate hired webhook
To create a candidate hired webhook, click the Configure icon on your navigation bar, then select Dev Center on the left.
Click Web Hooks > Web Hooks.
Create a new webhook using the following details:
- Name: We recommend something easily identifiable to an end user, such as [HRIS name] candidate export.
- When: Candidate has been hired
- Endpoint URL: The HRIS URL that will receive and transform the candidate data.
- Secret key: This can be set to any value. Greenhouse Recruiting combines the value set with the body of the webhook and uses the SHA256 algorithm to generate a signature header to include in the payload. When the webhook listener receives the webhook, the integration should compute the HMAC digest using the secret key and the body of the payload, then verify that Greenhouse Recruiting sent the webhook by comparing the signature header that was previously generated with the signature header included in the webhook.
- Error recipient email: The address that receives an email notification if the webhook fails. There is no in-app notification if the webhook fails after the initial ping.
If your HRIS endpoint requires additional Basic or OAuth authentication, click Advanced settings to configure.
Click Create Web hook to complete the setup.
Greenhouse Recruiting will ping your endpoint URL. If the ping is successful, the webhook will be created. If the ping is unsuccessful, your configuration will be saved, but the webhook will be deactivated.
Note: Your endpoint may require a username / password for the webhook to work properly. For an HRIS platform, the username is often formatted as username@tenant_name.
Once created, the webhook will sync new hire information to your endpoint each time a candidate is marked as hired. A single webhook will fire per candidate, even if multiple candidates are hired at the same time. Read more: Configure a candidate hired webhook.
What happens if I unhire and rehire a candidate?
The webhook will export new hire data each time you click Mark Candidate as Hired, even if the candidate has previously been marked as hired.
One webhook will fire per candidate, even if multiple candidates are hired at the same time.