Skip to main content
All CollectionsIntegrationsGreenhouse V2
How to set up the Greenhouse V2 integration
How to set up the Greenhouse V2 integration
Updated over a week ago

Important Note: Customers currently using the Greenhouse V2 integration will need to move to the Greenhouse V3 integration by August 31, 2024. TextUs will remove support for the Greenhouse V2 integration on September 1, 2024.

The TextUs integration for Greenhouse connects your TextUs accounts with your Greenhouse instance so that you can do the following:

  • Send and receive text messages with candidates in your Greenhouse account using the TextUs web app, Chrome extension, or mobile app.

  • Import phone numbers from Greenhouse into TextUs using the TextUs Chrome extension.

  • Log your team’s text conversations back to Greenhouse candidate records.

Getting started with your Greenhouse integration

Note: Your Greenhouse admin should complete the steps in this guide to ensure your integration has the correct account settings and permissions. This process should only need to be completed one time.

To integrate TextUs with your Greenhouse instance and synchronize data between the two platforms, complete the following steps:

Step 1: Generate an API key in Greenhouse

Your TextUs integration for Greenhouse requires you to generate an API key from your Greenhouse account. To create and copy your Greenhouse API key, complete the following steps:

  1. Log in to Greenhouse as an administrator.

  2. Click the gear icon in the top left of the screen and go Dev Center > API Credential Management.

  3. Click Create New API Key and enter the following on the Create new credential view:

    • API Type: Harvest

    • Partner: TextUs

    • Description: This field is automatically populated.

  4. Click Manage permissions.

  5. On the API key successfully created view, copy your API key. You will need your API key to complete the integration process in the TextUs web app.

  6. Click I have stored the API key to close the view.

  7. On the Manage permissions menu, select the access permissions for the API:

    • Activity Feed

      • All permissions

    • Candidates

      • GET: List Candidates

      • POST: Add Note

    • Users

      • GET: Retrieve User

      • GET: List Users

  8. Click Save.

Step 2: Enable your Greenhouse integration in TextUs

To integrate TextUs with your Greenhouse instance, complete the following steps:

  1. Log in to next.textus.com with your org admin user account.

  2. Click on your user icon and go to Accounts.

  3. On the Accounts page, find your org account at the top of the account hierarchy and click View.

  4. Click the Settings tab, then click Account Settings > Integrations.

  5. Click the Greenhouse v2 icon, then enter the following information:

    • Email: Enter you Greenhouse admin email

    • API key: Enter your Greenhouse API key

  6. Click Save.

  7. The integration process is complete. Your Greenhouse v2 icon on the Integrations page should now be toggled on.

Did this answer your question?