--- title: Greenhouse slug: greenhouse description: Discover how to seamlessly integrate Greenhouse with the Bindbee platform to add candidates, including API key management and submission steps for success. docTags: createdAt: 2025-10-10T10:19:43.000Z --- **Connecting to Greenhouse and writing a candidate** :::BlockQuote **Pre-requisite** : You will need an Admin Access to greenhouse dashboard ::: ::embed[****]{url="https://youtu.be/y9mZcosJs9U"} Start by opening the Bindbee dashboard. **Step 1:** Click on **Create Connector**. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/5cdce018-6aa1-418e-afe4-554650b5b500.png) **Step 2:** Enter an appropriate Organization name, category and unique-id. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/e02cdaad-218c-4342-8d98-92a277bad825.png) **Step 3:** Click **Next** and select **Greenhouse**. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/4bee884f-4b64-4920-8c4c-abcd7fcdf2e0.png) **Step 4:** Create a magic link and open link to add Greenhouse credentials. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/1ce1fe4e-5237-47df-b035-13573c9e66f0.png) **Step 5:** Open the magic link. Click on Allow and Continue to proceed. This will prompt for Greenhouse API Key. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/9fe25ab4-a395-47a6-bc42-26f75acddd83.png) ### Getting the Greenhouse API Key **Step 1:** In order to get the greenhouse API key, Open the Greenhouse dashboard and open Configure. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/56fd7685-23b2-4d58-89f2-92b20c4f75c5.png) **Step 2:** Open Dev Center ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/08baadf8-5fab-440e-a985-9e8f393bf8de.png) **Step 3:** Scroll down to the API Credentials ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/b63033fe-d406-48c6-b917-7edd0e0a4b8c.png) **Step 4:** Create a new API key. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/acd23a7f-e0e9-49a6-97ac-0868a9db618c.png) **Step 5:** Select **Harvest** as the API type. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/8dd783b6-0296-4811-b870-3e12c13e76b0.png) **Step 6:** Select appropriate partner. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/ac2147df-175f-47d4-b76a-2f55ea4b019c.png) **Step 7:** Provide an appropriate description. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/c84a566f-f45d-4e7c-a889-33868cd76e1d.png) **Step 8:** Click on **Manage Permissions**. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/198c9539-d505-4c0d-8c9d-2b4da5c6d648.png) **Step 9:** Copy and save the API key for future use. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/60edae18-91f8-4589-b39b-14e79891b54a.png) **Step 10:** Select all permissions under **Harvest V1 and select All**. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/80c60d2a-98b8-4948-8228-71d38216e4a9.png) **Step 11:** Scroll down and click **Save**. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/440949c1-ff23-4f12-bd1c-09be5a50a17a.png) **Step 12:** Go to the Bindbee API linking page and enter the new API key. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/087bdba5-0ee9-43f8-81c3-3cd3361c3964.png) **Step 13:** Click **Connect**. The connection will be successfully established. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/9672666f-65e1-4496-8ef1-a6371d03f879.png) **Step 14:** Check the connector's dashboard to confirm the connector has been created and the status is syncing. Wait for the data to sync. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/b43f16b3-e2c2-43d8-b14d-ddff7cc97d0c.png) ### Calling the API for Create Candidate **Step 1:** Retrieve the Bindbee API token from the settings and get the **API Key**. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/94bafdb5-5fd3-4168-ae8f-88876fb4fbfc.gif) **Step 4:** Go to the documentation at Bindbee docs : [https://docs.bindbee.dev](https://docs.bindbee.dev/ats/activity/get-activities). Navigate to the ATS section and then the Applications section. :::BlockQuote Note : you can use this request body ::: ```json { "data": { "first_name": "Jignesh", "last_name": "Patel", "company": "Google", "title": "SOFTWARE ENGINEER", "is_private": true, "can_email": true, "locations": ["44548 Trisha Summit, 61529 Wileyberg, UK"], "email_addresses": ["jignesh@patel.com"], "urls": [], "tags": ["good coder"], "applications": ["018b4bfb-5ece-70b1-ad5e-862a9433aa65"], "attachments": [], "avatar": "https://www.example.com/avatar.jpg", "job_id": "01932c4d-655e-708a-bfb4-1ec3765c2026" }, "remote_user_id": "01932c4d-59f9-7433-967e-f813f38c24b0" } ``` ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/1f16707d-2152-42c7-a20b-3a7a47932ba6.gif) **Step 5:** You will need Application Id and remote user id to create a candidate. So first we need to fetch the Application Id and then we will fetch the remote user id. **Step 6:** Click on **Get Applications**. **Step 7:** Add the API key to the Authorization field. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/a0f279b5-441f-4467-ae83-150dcbe35c10.gif) **Step 8:** Add the x connector token from the connector linking page. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/d8a5faf2-c2a3-4bb1-9f77-376b5fe8ee4b.gif) ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/f2bd1f1d-2556-4da1-88de-54ee64e92cbd.gif) **Step 9:** Click **Send**. Save the ID for the application. :::BlockQuote Note : The candidate created in Greenhouse is with respect to a job. So select the application id which has the job for which you want to create the candidate for ::: **Step 10:** Go to the Remote User and click on **Get Remote Users**. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/9630ec5b-52e4-4e1a-b92b-a8cf3d739b87.png) **Step 11:** Add the API key and x-connector-token as added in Application API to authenticate. Hit send to get the data. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/c0dcc52a-5828-4bf6-b2ff-aa1a6b4b7f9e.png) **Step 12:** Select the user with which you want the API to be called to the Greenhouse. Save the user's ID. **Step 13:** Now, to create a candidate, get the create remote create candidate URL. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/60fdfd14-dfc1-4360-896c-3f98eb6c247f.png) **Step 16:** Paste the URL into Postman. **Step 17:** Set the credentials accordingly for the request body and add appropriate credentials. **Step 18:** Copy the application ID and paste it into the Applications field. **Step 19:** Copy the remote user and paste it into the appropriate field. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/d8b4f188-1fbc-4c48-b06c-985b6b879fae.png) **Step 20:** Add an appropriate name and company. **Step 21:** Click **Send**. **Step 22:** If there's an error, ensure the correct user ID and x connector token are used. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/0f72517b-e177-4443-9562-085f19cd9299.png) **Step 23:** Click **Send** again. The candidate should now be successfully created. **Step 24:** Check the Greenhouse dashboard to confirm the candidate has been successfully created. ![](https://usercontent.us.prod.clueso.io/ebba768b-93c7-4a16-835c-91ebc7664eef/aac2e44e-786c-4d5c-8402-73eaa032f59d/19198de4-c797-4d16-bcd6-47e4449364b0/images/947f49ee-f3c6-4c06-ba09-33ab56049c02.png)