Connecting Paychex® to Built

Prev Next

For customers utilizing our Paychex integration. Supported integrations include Paychex Flex Select, Paychex Flex Pro, Paychex Flex Enterprise, HR Partner Plus, HR Pro, and HR PEO.


To connect Paychex to Built:

Only Company Admins and HR Admins can manage integrations. Learn more about managing user roles and permissions.

  1. At the top of the main navigation, click your company name, then click Integrations.

    If you do not already have a Built account, please connect with our team before initiating your Paychex integration.

  2. When the Integration page opens, locate and click the Paychex tile.

  3. Click the + Add Integration button. You will be prompted to contact our Customer Success Team to schedule an implementation call to connect your integration, configure your account settings, prepare your initial import, and address your questions. Click Continue.

    Notes about importing Paychex data:

    • If you already have a Built account containing data, we will request your permission via email to clear existing data, ensuring information is not duplicated when importing directly from Paychex.

    • If a Built Position ID custom field has been created in Paychex, Built’s position IDs will be sent back to Paychex during the initial import.

  4. On your implementation call, you’ll be asked to provide your Paychex Client ID, located in the upper-left corner of your Paychex Flex account. You will then receive a link to grant Built access to your Paychex account. The link will open your Paychex account and display a checkbox to agree to the terms of use before clicking Approve. Once connected, daily automatic imports will be enabled.

Importing Paychex Data

Once connected, you can adjust your integration settings as needed to reflect your organization’s import preferences and more. You can also initiate a manual import from the Integrations page at any time by clicking the three-dot menu on the Paychex tile, then clicking Start Manual Import. Please refer to the tables below for the data requirements for importing data from Paychex.

If you'd like to exclude specific individuals, people data, or position data from your import, please contact our Customer Success Team.

People Data

People Data Imported from Paychex

Built Field

Corresponding Paychex Field

Required

Base Pay Quantity

Standard Pay Period

No

Base Pay Rate

Amount

No

Base Pay Type

Pay Type

No

Birth Date

Birth Date

Yes

Cell Phone

Mobile Phone

No

Effective Date (Pay)

Apply Edits

No

Employee ID

Employee ID

Yes

Employee Status

Employment Status

Yes

Employee Type

Employee Type

No

First Name

Legal First Name

Yes

Gender

Sex

No

Hire Date

Hire Date

No

Home Address

Street Address

Street Address 2

City/Town

State/Region

Postal/Zip Code

Country

Address

Address One

Address Two

City

State

Zip

Country

No

Home Phone

Home Phone

No

Last Name

Legal Last Name

Yes

Middle Initial

Legal Middle Name

No

Office Phone (w/ ext)

Work Phone (w/ ext)

No

Personal Email

Personal Email

No

Photo

Profile Image

No

Termination Date

Status Date

No

Termination Reason

Reason for Change

No

Work Email

Work Email

No

Notes about imported people data:

  • Future hires will be automatically imported, regardless of their hire dates. To ensure new hires are assigned to the correct position at the appropriate time, we recommend specifying future effective dates when assigning individuals to Built positions in Paychex.

  • When updating position assignments, we recommend entering the appropriate Built position IDs in Paychex prior to scheduled imports, ensuring that new positions are not created unnecessarily.

  • Company Admins and HR Admins can choose whether preferred names or legal names are imported from Paychex when configuring the organization’s general HRIS integration settings.

  • Compensation records imported from Paychex will be automatically set to your organization’s configured reporting currency. Learn about managing the reporting currency for an individual’s compensation record, once imported.

  • Only individuals with the following pay types in Paychex will have their compensation records imported:

    • Salary

    • Hourly

  • While it is possible to have multiple pay rates in Paychex, only the employee’s “Default” pay rate will be imported as a compensation record in Built.

Position Data

Position Data Imported from Paychex

Built Field

Corresponding Paychex Field

Required

Employee Type

Type

No

Full Time Equivalent (FTE)

Standard Hours

No

(Position) Location

Location

No

Reports To

Supervisor

Yes

Title

Position

No

FTE is only imported for hourly employees with defined standard hours and is calculated by dividing standard hours by 40. FTE is not imported for salaried employees or hourly employees without defined standard hours.

Job Definition Data

Job Definition Data Imported from Paychex

Built Field

Corresponding Paychex Field

Required

Title

Position Name

Yes

Location Data

Location Data Imported from Paychex

Built Field

Corresponding Paychex Field

Required

Name

Name

Yes

Street Address

Street Address 2

City/Town

State/Region

Postal/Zip Code

Country

Address Line 1

Address Line 2

City

State

Zip

Country

No

Notes about imported location data:

  • Only active work locations can be imported; non-work locations and work locations that are not yet active cannot be imported.

  • Time zones for locations will be set to your organization’s configured default location's time zone.  

To disconnect your integration:

  1. Navigate to the Integrations page.

  2. Locate the Paychex tile, click the three-dot menu, then click Remove Integration.

  3. Click Remove to confirm this action.

    Future imports cannot be initiated after disconnecting your integration.

Please contact our Customer Success Team for additional assistance.

Additional Resources

Connecting People Imported from Paychex® with Newly Assigned Positions

Supported API Integrations