Paychex offers HR and payroll solutions to fit the needs of any size business. The Paychex Flex integration with Greenhouse Recruiting allows a one-way sync where a new hire in Greenhouse Recruiting intiates the creation of a new worker in Paychex Flex. The worker's record is populated with information from their application and job details in Greenhouse Recruiting. From there, hiring and entering additional details for the worker can be completed within Paychex Flex.
Set up the integration
Setup of the Paychex Flex integration with Greenhouse Recruiting is a collaborative process between you, a Paychex Payroll Specialist, and a Paychex Integration Support Specialist.
Create an ISU
Rather than requiring a specific user at your organization to authenticate an integration, which could cause downstream errors if the person loses permissions or can't access Greenhouse Recruiting, an ISU allows you to create a solid infrastructure for your organization's integration needs.
Follow the steps in this article to create an ISU in Greenhouse Recruiting for the Paychex integration Name the ISU Paychex integration.
Save the ISU's email address for use in a later step.
Create a Harvest API key
Next, 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 new key:
In the Create New Credential box, make the following selections:
- API type: Harvest
- Partner: Paychex or Unlisted Vendor
- Description: Paychex Harvest API key
Verify that the following permissions are selected for the Paychex integration:
Departments
- GET: List departments
- GET: Retrieve department
Users
- GET: List users
Candidates
- GET: List candidates
- GET: Retrieve candidates
Offices
- GET: Retrieve offices
- GET: List offices
Custom fields
- POST: Create custom field
- PATCH: Update custom field
- GET: Get custom fields
Save your API key to a secure location for use in the next step.
Enable on Paychex
Note: Only Admin users in Flex can access and manage these settings.
Next, log in to Paychex Flex, and click Company Settings > Integrated Apps.
Click Integrated Apps to open your app drawer. Find the Greenhouse by Paychex integration.
Toggle Allow Access, then click Enter Credentials.
Enter the following information:
- API key: Paste the API key created in the last step.
- User email: Paste the email address of the ISU account created in the previous step.
- Environment: Select Production.
Click Connect.
Note: You can use this workflow to edit or disconnect these credentials later. However, for data security, the API key isn't visible after it's entered.
Create a webhook
Finally, log in to Greenhouse Recruiting to create a webhook. Follow the steps in this article to create your webhook, and use the values listed below to configure the webhook:
- Name: Paychex integration
- When: Candidate has been hired
- Endpoint URL: Enter the Endpoint URL provided by Paychex
- Secret key: Enter the secret key, or signing key, provided by Paychex
Once complete, the Paychex integration is setup and ready to use.
Use the integration
When candidates are marked as hired in Greenhouse Recruiting, candidate data is transferred to Paychex Flex. The integration then uses the candidate's email address to either create a new worker record in Paychex Flex or update a previously synchronized worker.
Note: In general, it takes about 5 minutes for new hires to sync to Paychex.
The following information is synced by default from Greenhouse Recruiting to Paychex Flex:
| Greenhouse Recruiting field | Paychex Flex field | Notes |
| First Name | First Name | |
| Last Name | Last Name | |
| Email Address | Worker Email, personal or business | Greenhouse Recruiting has three email types: personal, work, and other. By default, the personal email type is used for Flex Personal Email, and the work email type is used for Flex Work Email. These defaults can be modified during integration setup by Paychex Flex. In the event a candidate has multiple email addresses of the same type, the first email address is synced. |
| Phone Number | Phone Number | Greenhouse Recruiting has five phone number types: home, work, mobile, Skype, and other. By default, the personal phone number type is used for Flex Personal Phone, the work phone number type is used for Flex Work Phone, and the mobile phone number type is used for Flex Mobile Phone. These defaults can be modified during integration setup by Paychex Flex. In the event a candidate has multiple phone numbers of the same type, the first phone number is synced. |
New hire workers
When a candidate is hired in Greenhouse Recruiting with an email address that doesn't match a currently integrated Paychex Flex worker, the integration identifies them as a newly hired worker and creates a new in progress worker with information pulled from the Greenhouse Recruiting candidate profile.
Re-hired workers
When a candidate is hired in Greenhouse Recruiting with an email address that matches a currently integrated Paychex Flex worker, the integration identifies them as an existing worker. If the worker is currently terminated or inactive within Paychex Flex, they'll be rehired or reactivated with updated information from the Greenhouse Recruiting candidate profile.
Custom fields
In addition to standard fields, the integration can sync custom candidate fields to Paychex Flex. During the integration's implementation, you can choose which custom fields are used, along with any other customizations. Check out these additional custom fields options below:
| Greenhouse Recruiting custom field | Paychex flex custom field | Notes |
| Worker type | Worker type |
For options, use:
If this custom field isn't used, or a value isn't provided, the integration defaults new workers to "Employee" worker type. Note: This field can't be modified during a rehire event. |
| Hire date | Hire date | |
| Type of Employment | Employment type |
For options, use:
|
| Home Address Line 1 | Home Address Line 1 | |
| Home Address Line 2 | Home Address Line 2 | |
| Home Address City | Home Address City | |
| Home Address State | Home Address State | |
| Home Address Zip | Home Address Zip | |
| Rate Type | Rate 1 Type |
For options, use:
|
| Rate Amount | Rate 1 Amount | |
| Ethnicity | Ethnicity |
For options, use:
Note: This field can't be modified during a rehire event. |
| Gender | Gender |
For options, use:
|
| Birth Date | Birth Date |
|
| Name Suffix | Name Suffix |
|
| Salutation | Salutation |
|
| Preferred Name | Preferred Name |
|
| Middle Name | Middle Initial |
|
| Fed Filing Status | Federal Filing Status |
|
| Job Position Title | Job Title |
|
Note: The custom field names listed are defaults and may be modified on request to Paychex. For example, Birth Date could be set to show as Date of Birth in Greenhouse Recruiting.
Additional resources
For a detailed integration walkthrough or troubleshooting not covered here, reach out to your dedicated Paychex representative.