Apideck provides the infrastructure building blocks for B2B SaaS companies to enable them to build and market integrations through one platform.
Our Unified APIs standardize APIs across different software categories for a better Developer Experience, enabling developers to build integrations through a single API and launch integrations faster.
Apideck's integration with Greenhouse Recruiting offers a ready-to-use solution for easily requesting published job postings and accessing applicant tracking information.
Set up the Apideck integration
Create a Harvest API key
To configure the Apideck 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 Apideck integration.
Credentials
In the Create New Credential box, make the following selections:
- API Type: Harvest
- Partner: Apideck or Unlisted Vendor
- Description: Apideck Harvest API Key
Permissions
Note: When selecting permissions for your API key, you have two options: Click Select All to choose all permissions or manually select the specific permissions required for your customer as outlined below.
At a minimum, select the GET: List Candidates permission under the Candidates category.
Verify that the following permissions are selected for the Apideck integration:
Job Openings
- GET: List Openings For a Job
- POST: Create openings
- PATCH: Edit openings
- DELETE: Delete openings
Jobs
- Post: Add hiring team member
- Get: Get hiring team
- Patch: Update Job
- Post: Create a new job
- Get: List Jobs
- Get: Retrieve Job
- Put: Replace hiring team
- Delete: Remove hiring team member
Job Stages
- Get: Retrieve Job Stage
- Get: List Job Stages for Job
- Get: List Job Stages
Applications
- Post: Reject Application
- Patch: Update Application
- Post: Unreject Application
- Patch: Convert a prospect
- Post: Advance Application
- Post: Add Attachment to Application
- Get: Retrieve Application
- Post: Moves Application to Job
- Post: Move Application
- Get: List Applications
- Post: Hire Application
- Patch: Update a rejected application's rejection reason
- Delete: Delete Application
Candidates
- Delete: Delete Employment
- Post: Add Note
- Post: Add Application
- Get: List Candidates
- Post: Add Candidate
- Delete: Delete Education
- Post: Add E-mail
- Patch: Edit Candidate
- Put: Anonymize Candidate
- Get: Retrieve Candidate
- Put: Merge two candidates
- Post: Add Attachment
- Post: Add Employment
- Post: Add Education
- Post: Add Prospect
- Delete: Delete Candidate
Custom Fields
- Post: Create custom field
- Patch: Update custom field
- Get: Get custom fields
- Delete: Delete custom field
Offers
- Get: List Offers
- Get: Retrieve Offer
- Get: Retrieve Application's Current Offer
- Patch: Update Application's Current Offer
- Get: List Application's Offers
Tags
- Put: Add a candidate tag
- Get: List Candidate Tags
- Delete: Remove Candidate Tags
- Post: Add New Candidate Tags
- Delete: Remove tag from candidate
- Get: List tags applied to candidate
Custom Field Options
- Patch: Update custom field options
- Get: Custom field options
- Delete: Remove custom field options
- Post: Create custom field options
Sources
- Get: List Sources
When finished, click Save.
Your Harvest API key for the Greenhouse Recruiting / Apideck integration is created and configured. Copy the API key to provide to Apideck in the next step.
Connect your API credentials to the Apideck Vault
Once you've created your Harvest API key, you'll need to enter the key in Apideck to authorize access. You’ll also need to provide your job board URL to make your jobs available to Apideck.
You can find your Job Board URL in Greenhouse Recruiting by navigating to the Job Board settings (Configure > Job Boards & Posts > Ellipsis icon next to job board > Edit Board Settings).
On the Edit Board Settings page, scroll to the URL field and copy the link.
Once copied, navigate to Apideck and locate your settings. (Vault > Configuration > Connectors > ATS API) Next, enter the API key and Job board URL.
Save when finished.
Use the Apideck integration with Greenhouse Recruiting
After setting up the integration, you can use Apideck Unify API to streamline various recruiting and candidate management tasks, including:
- Data Access: Gain access to job postings and candidate information using the uniform data model.
- Data Synchronization: The integration allows you to synchronize data between Apideck and Greenhouse Recruiting. This can include candidate information, job postings, and more.
Additional resources
For additional information or troubleshooting not covered here, reach out to support@apideck.com or visit the online setup guide from Apideck.