Paraform’s integration with Greenhouse Recruiting allows companies looking to hire to seamlessly integrate Paraform into your existing candidate pipeline by automatically uploading new candidates from Paraform to your jobs on Greenhouse. Candidate updates made on Paraform will reflect in your Greenhouse account and vice versa, keeping Paraform recruiters informed with the most up-to-date status of their candidates.
Create a Harvest API key
To configure the Paraform integration, you’ll need to create a Harvest API key.
Follow the steps in this article to create the key, and verify that the permissions below are selected when configuring the Paraform integration.
Credentials
In the Create New Credential box, make the following selections:
- API Type: Harvest
- Partner: Paraform or Unlisted Vendor
- Description: Paraform Harvest API Key
Permissions
Verify that the following permissions are selected for the Paraform integration:
Users
- GET: List Users
- GET: Retrieve User
Applications
- POST: Reject Application
- PATCH: Update Application
- POST: Advance Application
- POST: Add Attachment to Application
- GET: Retrieve Application
- POST: Move Application
- GET: List Applications
- POST: Hire Application
- DELETE: Delete Application
Jobs
- GET: List Jobs
- GET: Retrieve Job
Candidates
- POST: Add Note
- POST: Add Application
- GET: List Candidates
- POST: Add Candidate
- POST: Add E-mail
- PATCH: Edit Candidate
- GET: Retrieve Candidate
- POST: Add Attachment
- POST: Add Employment
- POST: Add Education
- DELETE: Delete Candidate
Job Posts
- GET: Retrieve Job Post for Job
- GET: List Job Posts for Job
- GET: List Job Posts
Scheduled Interviews
- GET: List Interviews
- GET: List Interviews for Application
- GET: Retrieve Interview
Job Stages
- All permissions
Offers
- All permissions
Rejection Reasons
- All permissions
Add your API key to Paraform
Add your Greenhouse API Key in Paraform and verify permissions
Link your Paraform roles to your Greenhouse jobs
Select a Greenhouse user for Paraform to assign as the On-Behalf-Of user. Note that candidate ownership will be assigned to the corresponding Greenhouse job owner regardless of the chosen On-Behalf-Of user.
Create a webhook
To integrate Paraform with Greenhouse Recruiting, you’ll also need to create a webhook. Follow the steps in this article to create your webhook. Use the values listed below to configure the webhook:
- Name: A descriptive name for your integration. Most customers choose ‘Paraform integration - <event name>’
-
When:
- Candidate has been hired
- Candidate has changed stage
- Candidate or Prospect rejected
- Candidate or Prospect unrejected
- Candidate has been unhired
- Offer Created
- Endpoint URL: Copy and Paste your Endpoint URL for the webhook in your Paraform Dashboard
- Secret Key: Copy and Paste your Secret Key from your Paraform Dashboard.
Add your webhooks to Paraform
Once webhooks are created, verify that all webhooks have been confirmed on Paraform
Use the Paraform integration with Greenhouse Recruiting
Setting up your role in Paraform
Once you’ve set up your API key and webhooks, you can now link your interview stages with your role on Paraform.
Choose a Greenhouse Recruiting interview plan (aka job) for your Paraform role. This will allow you to import the interview stages from this plan.
Choose which stages to import to Paraform. Typically, users will opt out of importing lead or hire stages, only importing review and technical interview stages.
Configure the stage at which you want candidates to be uploaded to Greenhouse. This is denoted by the “Upload to ATS” badge on the selected stage.
You’re all set! Candidates will have their status synced between Greenhouse and Paraform.
Paraform candidates in Greenhouse Recruiting
When your candidate is moved to the “Upload to ATS” stage in Paraform, they will be automatically uploaded to Greenhouse to the corresponding stage. From there, any stage changes will be reflected in Paraform, allowing us to keep Paraform recruiters as up-to-date as possible.
Additional resources
For additional information or troubleshooting not covered here, reach out to patrick@paraform.com.