Integrate with Puzzle

Connect to Gusto during your Puzzle onboarding

If you're setting up a brand new Puzzle account, here's how to integrate it with Gusto during onboarding. 

1. Start your onboarding with Puzzle.
2. Step 4 of Puzzle onboarding includes the option to connect your payroll accounts. In the list of payroll integrations, find Gusto and click Connect.
   • If you do not see this option, you can connect to Gusto once you finish onboarding. Refer to the steps below under "Connect to Gusto from an existing Puzzle account." 
3. Enter your Gusto admin credentials and click Sign In.
4. Click Authorize.
5. You'll be redirected to your Puzzle onboarding page. A green check mark next to "Gusto" indicates that your data has begun syncing. 

Connect to Gusto from an existing Puzzle account

If you have already set up both Gusto and Puzzle accounts, follow these steps to connect them.

1. Sign in to Puzzle.
2. Go to Integrations.
3. Scroll to "Payroll and Benefits" and click Add integration.
4. Find "Gusto" and choose Connect.
5. Enter your Gusto admin credentials and click Sign In.
6. Click Authorize.
7. You'll be redirected to Puzzle's Integrations page. In the pop-up, select what time frame you'd like data to be synced from. 
   
   • The default is for all available Gusto data to be synced. You can choose a custom date if desired.

If you’ve connected successfully, you’ll see Gusto listed as a linked account on the Connected Accounts screen.

The flow of information is one-way, from Gusto to Puzzle. All changes to payroll or benefits information must be made in Gusto. For this reason, any information pushed from Gusto to Puzzle will be read-only while you’re in your Puzzle account. 

• Auto-sync will only work for the payrolls moving forward from the time it is set up.
  • Puzzle will auto-sync on a daily basis in the evening.
  • The sync pulls data from the last two months from the connected Gusto accounts.
• Make any updates to information in Gusto first. 
  • If there are any updates to your Gusto data (such as a change to name, status, job/title, compensation, etc.), Puzzle will pull that in from the sync and notify you that the information also needs updating in Puzzle. This will help make sure information matches in both platforms.

1. Sign in to Puzzle.
2. Click Connected Accounts.
3. Click Gusto.  
4. You should see:
   • Pay period date range
   • Last attempted sync date and time 
   • Last successful sync date and time

If there’s an issue with the payroll sync, you’ll see a notification on your Puzzle dashboard and an error message under the Connected Accounts menu. Follow the instructions to resync your payroll.

The sync will not run if an admin's Gusto or Puzzle login credentials have changed.

If you're notified that the sync has been disconnected, here's how to reconnect:

1. Sign in to Puzzle.
2. Go to Integrations.
3. Scroll to "Payroll and Benefits" and click Add integration.
4. Find "Gusto" and choose Connect.
5. Enter your Gusto admin credentials and click Sign In.
6. Click Authorize.
7. You'll be redirected to Puzzle's Integrations page. In the pop-up, select what time frame you'd like data to be synced from. 
   
   • The default is for all available Gusto data to be synced. You can choose a custom date if desired.

If the sync is working but you notice a data issue, reach out to Puzzle directly through the chat icon in the Puzzle app.

Disconnect just one account

If you've connected multiple accounts to Puzzle, here's how you can remove one of your Gusto accounts from the integration. Any other accounts you've integrated can remain connected. 

Historical data (any data that has already been synced from Gusto to Puzzle) is not deleted and will remain in Puzzle.

1. Sign in to Puzzle.
2. Go to Integrations.
3. Scroll to "Payroll and Benefits" and find Gusto.
4. Next to the account you want to disconnect, click Manage Account.
5. Choose your preference: 
   • Deactivate: Data will no longer sync from that Gusto account to Puzzle.
   • Archive: Data will no longer sync from that Gusto account to Puzzle, and that account will be hidden from the Puzzle Integrations page. 

Fully disconnect the integration

Follow these steps if you no longer want data to sync from Gusto to Puzzle. You can reconnect the integration at any time.

Historical data (any data that has already been synced from Gusto to Puzzle) is not deleted and will remain in Puzzle. 

1. Sign in to Puzzle.
2. Go to Integrations.
3. Find Gusto and choose Manage Integration.
4. Click Disconnect.
5. Choose Disconnect Integration.

Learn more about integrated payroll in Puzzle's Help Center.

You can also contact Puzzle directly at [email protected]. or chat live on Puzzle's website.