Phenom People

The Phenom People Platform combines a hyper-personalized career site experience for candidates with tools for talent acquisition professionals and recruiters. Increase your talent pool with quality candidates who do not apply or before they apply using Phenom People's passive candidate detections technology. Promote internal career growth and employee referrals with the personalized internal mobility and referral portal, etc.

Greenhouse Recruiting’s integration with Phenom People allows for jobs created and posted in Greenhouse Recruiting to be sent to your Phenom People hosted career site.  It also allows for application data to be sent from your Phenom People hosted career site back into Greenhouse.  In this article, we will cover how to:

 

Configure User Setup Permissions in Greenhouse Recruiting

In order to enable the Greenhouse/Phenom People integration, you will need the developer permission Can manage ALL organization’s API Credentials.

Contact a Greenhouse user in your organization with Site Admin level permissions with the additional user-specific permission Can edit another user's advanced permissions to apply the API credential management permission to your account. Have the user with Site Admin level permissions edit your user account's permissions by navigating to the Configure icon Configure.png > Users > Your Name.

1._Configure_-_Users.png

The user with Site Admin level permissions should navigate to the Permissions panel on your user page and expand the Developer Permissions dropdown menu.

Select Can manage ALL organization’s API Credentials so that a check is in the checkbox. When finished, click Save.

ALL_API_Credentials.png

Repeat as necessary for any other user that should have access to set up the integration.

 

Retrieve Greenhouse Job Board Token

A job board token is a unique alphanumeric identifier associated with a single job board for your organization. By sharing a job board token with Phenom People, you will allow Phenom People to pull your open jobs.

Click the Configure icon Configure.png in the upper right-hand corner and navigate to Job Boards & Posts on the left-hand panel.

Configure_-_Job_Boards___Posts.png

Navigate to a job board on the subsequent page and click the ellipsis icon ellipsis.png inline with the job board name. Select Edit from the dropdown menu.

Job_Boards_-_Edit_Board_Settings.png

Navigate to the URL section of the Edit Your Job Board page. Your job board token is located in the provided field.

Job_board_token.png

Copy this job board token and share the value with your Phenom People representative.

 

Create Greenhouse Harvest API Key 

To create a Harvest API key for the integration, click on the Configure icon Configure.png in the upper right-hand corner. Navigate to Dev Center on the left-hand panel. From the Dev Center page, click API Credential Management.

1._Dev_Center_-_API_Credential_Management.png

From the API Credential Management page, click Create New API Key to generate the API key for Phenom People.

2._Create_new_API_key.png

In the Create New Credential dialog box, make the following selections:

  • API Type: Harvest
  • Partner: Phenom People
  • Description: Phenom People Harvest API Key

When finished, click Manage Permissions to generate the Harvest API key and automatically assign it the appropriate permissions required by Phenom People.

mceclip0.png

In the subsequent dialog box, click Copy to save your API key to your clipboard. Store the API key in a secure location to provide to Phenom People in the next step. Click I have stored the API Key once you have copied and saved the key.

Note: You cannot access the full API key again after clicking I have stored the API Key. If you lose your API key and need to access it later, you must create a new API key, provide it to the integration partner, and then revoke access to the original key.

3._API_key_created.png

On the subsequent page, confirm the following permissions are assigned to your new API key:

mceclip1.png

If any of the permissions above are not checked, place a check in the box next to the appropriate permission. Click Save when finished. 

Your Harvest API key for the Greenhouse Recruiting / Phenom People integration is created and configured. Provide the Harvest API key to your Phenom People onboarding team so they can set up the integration.

 

Create Greenhouse Job Board API Key

In addition to the Greenhouse Harvest API Key, Phenom People will also need a Greenhouse Job Board API Key.

To create a Job Board API key for the integration, click on the Configure icon Configure.png in the upper right-hand corner. Navigate to Dev Center on the left-hand panel. From the Dev Center page, click API Credential Management.

1._Dev_Center_-_API_Credential_Management.png

From the API Credential Management page, click Create New API Key to generate the API key for Phenom People.

2._Create_new_API_key.png

In the Create New Credential dialog box, make the following selections:

  • API Type: Job Board
  • Description: Phenom People Job Board API Key

When finished, click Create to generate the Job Board API key.

mceclip2.png

In the subsequent dialog box, click Copy to save your API key to your clipboard. Store the API key in a secure location to provide to Phenom People. Click I have stored the API Key once you have copied and saved the key.

Note: You cannot access the full API key again after clicking I have stored the API Key. If you lose your API key and need to access it later, you must create a new API key, provide it to the integration partner, and then revoke access to the original key.

3._API_key_created.png

Your Job Board API key for the Greenhouse Recruiting / Phenom People integration is created and configured. Provide the Job Board API key to your Phenom People onboarding team so they can set up the integration.

 

Use the Phenom People Integration with Greenhouse

Jobs which are created and made live on Greenhouse, will be integrated to your Phenom hosted career site.  When a candidate applies for a job on Phenom, the candidate application information will be sent to Greenhouse.  Once the candidate has applied for the job, a recruiter can make changes to the application status.  The talent gateway integration with Greenhouse will allow the status to be in-sync between Greenhouse and Phenom’s Real-Time CRM.

 

Get Help

Please contact support@phenompeople.com for troubleshooting assistance regarding the integration.