Gusto is a modern, online people platform that helps small businesses take care of their teams. On top of full-service payroll, Gusto offers health insurance, 401(k), expert HR and team management tools.
The Gusto <> 15Five API integration allows you to provision users and pass employee data from Gusto to 15Five. You also have the option to sync performance data from 15Five to Gusto.
The 15Five <> Gusto integration is available for all Gusto customers. The auto-provisioning functionality is available to Gusto customers on the Complete or Concierge tiers.
What you’ll find in this article:
- Integration overview
- Set up the integration in 15Five
- Complete integration setup in Gusto
- Provision a new hire’s 15Five account from Gusto
- Disable syncing from Gusto to 15Five
- Deprovision 15Five accounts in Gusto
- Disconnect the integration
- Provision Gusto accounts in 15Five
- Match existing 15Five users to Gusto accounts
- Sync employee data from Gusto to 15Five
- Add users to groups in 15Five
- Sync performance data from 15Five to Gusto
API data fields transferred
|Gusto field||15Five field|
|First name (chosen first name is used if set up in Gusto)||First name|
|Last name||Last name|
Set up the integration in 15Five
Enable the Public API
- Click on the Settings gear in top right-hand corner of 15Five.
- Select 'Features' from the dropdown menu.
- Scroll to the bottom of the page and click 'Integrations'.
- Click Enable to the right of the Public API option.
- You'll land on the 'Company API keys' page.
Generate an API key
- On the 'Company API keys' page, click the Create new key button.
- Add in a short name for your API key. This name can be anything; typically it's a name that is easily identifiable from your server-side (for example, "Gusto API key"). Do not check the box next “Limit access to High Fives only.”
- Click Save.
- You will be directed back to the 'Company API keys' page, where you will see the new API key and access token. Copy the API key so you can add it in Gusto – save it somewhere safe in the meantime.
A Public API key is 32 characters long- not to be confused with a SCIM key, which is 30 characters long.
The endpoint for your API, assuming you do not have a unique subdomain in 15Five, is my.15five.com.
Complete integration setup in Gusto
Enter your API key into Gusto
- Sign in to your Gusto admin account.
- Navigate to 'App Directory' on the left hand side of your dashboard and select 15Five (located under 'Performance').
- Click Connect.
- Copy and paste your API key from 15Five into the modal and click Continue to setup.
Match accounts in Gusto to 15Five
- Match each employee’s Gusto and 15Five accounts by clicking Select an option next to their name.
- Add as a new employee creates a new Gusto profile for the employee and lets you add them to payroll.
- Don’t match in Gusto excludes that person from the integration. Their 15Five access and data won’t be affected.
- Match with existing Gusto account lets you select the Gusto profile to match with their 15Five account.
- After making your selection, click Match accounts.
Your 15Five and Gusto accounts are now connected and syncing.
Provision a new hire’s 15Five account from Gusto
- Navigate to the 'Hiring' tab in Gusto.
- Click Hire a new person.
- Click Employee and then check the box to send an offer letter, if you’re using Gusto for that process. Then, click Continue.
- Complete the employee profile and select Save & continue.
- Navigate to 'Create [employee name] software accounts' and click Start to the far right.
- Review the current apps available to this employee and click Save & continue.
- Make sure the box is checked for 15Five and select Save & continue.
- Review the details on the below page and click Create accounts.
For employees with hire dates in the past, the 15Five enrollment email will be sent to the employee immediately. For employees with hire dates in the future, the email will be sent on their hire date.
Disable syncing from Gusto to 15Five
If you no longer want an employee to sync from Gusto to 15Five, you can unmatch their accounts within Gusto using the following steps. This will not deactivate the individual in Gusto or remove them from anything other than the 15Five syncs.
- In Gusto, navigate to App directory→ Connected apps.
- Select '15Five'.
- Click Match accounts.
- Select the dropdown next to the employee’s name and click the Unmatch account option. It is important to note the difference between unmatching an account vs. deleting an account. Deleting an account will remove an employee's account and access to 15Five.
- Click Match accounts once more.
- All done! The employee will no longer be included in syncs from Gusto to 15Five.
Deprovision 15Five accounts in Gusto
Deprovision accounts with a Gusto termination
If you are terminating an employee that has a 15Five account, you’ll be able to remove their access to 15Five as part of the Gusto termination.
- In Gusto, navigate to the 'People' tab and select the employee you want to dismiss.
- Find the 'Actions' section and click Start employee dismissal.
- Complete the dismissal details and click Save & continue.
- Uncheck the box for 15Five to have it removed from the employee and click Save & continue.
- You’ll see a confirmation page summarizing the details of the termination and the removal from 15Five. Click Dismiss employee.
- You’ll see a confirmation screen confirming the dismissal.
Deprovision accounts without a Gusto termination
- In Gusto, navigate to Settings→ Integrations→ Connected apps.
- Select '15Five'.
- Click the three dots under the 'Action' column next to the employee you’d like to unmatch.
- Click Remove account.
- Review the pop up modal before clicking Remove.
- The individual will no longer have access to 15Five.
Disconnect the integration
If you wish to discontinue any and all employee data syncing between Gusto and 15Five, essentially disconnecting the integration, you can disable it in the 'Settings' menu in Gusto.
- In Gusto, find the 15Five integration page and click to open the 'Settings' tab.
- Click on the edit button to the right of the 'Data settings' option. Then uncheck the 'Basic employee information' box and click Update settings.
- The Gusto <> 15Five integration will be immediately disconnected, and will no longer sync any employee data.