All Collections
How to Integrate with Gusto
How to Integrate with Gusto

Step-by-step instructions on how to setup and use the Gusto integration.

Rachel avatar
Written by Rachel
Updated this week

Overview: The integration with Gusto is done through an export/import process. When it's time to process payroll, you will export the Gusto-specific file and upload it into their system.


Enable the Gusto Integration

1. To enable the Gusto integration, start by going to Settings --> Integrations:

2. Click the Gusto Settings button:

3. Check the box next to Enable Integration with Gusto. Then enter your Gusto Codes, and click Save once done.

Note: Regular, overtime and double time are mapped automatically. The other mapping categories are controlled by your Time Off Types, which can be found by going to Settings --> Time Off in Buddy Punch.

Enter Employee IDs

Any worker you want to show up on the Gusto export needs to have an Employee ID and this needs to match what's in Gusto.

More details on where to find/enter the Employee ID in Buddy Punch can be found here:

Map Location or Department Codes (Optional)

When using the Gusto integration, you have the option of mapping Location or Department Codes to Gusto's Title option.

1. To enable and set up this feature, check the box on the Gusto integration page next to Use Multiple pay rates, Gusto Titles must match a Buddy Punch: and select whether you'd like to map Locations, Department Code Names or Department Code Payroll Code:

1a. Location Name refers to the actual name of any Location codes you've set up in Buddy Punch. You can find this information by going to Settings --> Locations.

1b. Department Code Name refers to the name of any Department Code you have set up in Buddy Punch and Department Code Payroll Code refers to the Payroll Code under the name:

2. After setting up and mapping your Locations or Departments, you must create pay rates and job titles to match these codes in the Gusto system.

To add multiple pay rates for hourly employees, please follow the below steps:

  • Click the People tab.

  • Click your employee’s name.

  • Navigate to the Job & Pay tab.

  • In the Compensation section, click Add Earning Type or Pay Rate.

  • Select the earning type or additional pay rate.

  • Next to Job Class Code, select the appropriate risk class code. Applicable only to those who have a workers' comp policy through Gusto - skip to step 7 otherwise.

  • Enter the pay rate.

  • Next to Default Hours per Pay Period, enter a default amount if applicable. This is required if you are using AutoPilot.

  • Click Save.

  • The first pay rate will now be titled Primary Position.

Once you've set up the pay rate, you can update the Job Title by clicking Edit next to the pay rate.

Important: The name of the job title needs to match what is found in Buddy Punch. For example, Location A in Buddy Punch needs to have a matching Location A job title in Gusto. A job title must be created in Gusto for each Location or Department mapped in Buddy Punch.

If you have questions about setting up job titles in Gusto, please contact Gusto support for assistance.

Export the Gusto File

1. To export the Gusto file, go to Reports --> Payroll Export:

2. Choose your pay period and any filters, and click Run Report. You'll then want to click the Export dropdown followed by Gusto Format:

Import into Gusto

1. In Gusto, navigate to the Run Payroll tab and begin running a payroll.

2. Click Upload CSV in the upper right corner of the page. Upload the file you downloaded from our system:

Once the hours are uploaded, you can review and proceed with your payroll process as normal. We recommend contacting your Gusto representative if you have questions about this process.

Did this answer your question?