Introduction

📘

Welcome to our refreshed Embedded Payroll API docs!

Looking for App Integration docs? Click here.

Overview

We spent 10+ years building a smart and compliant payroll product, and let us be the first to tell you: it’s no easy task. That’s why we’ve created Gusto Embedded Payroll — to help more companies provide modern payroll and HR tools to their customers within weeks. With Embedded Payroll, you can build customizable payroll experiences into your software that businesses are already running on: whether it's a vertical SaaS platform, point of sale, or e-commerce.

Get API Keys

To kick off development, go to Gusto's Developer Portal to create an account and setup your Organization. Embedded Developer accounts are specifically tailored to the needs of Gusto Embedded partners. On top of the base feature-set in Developer Portal, Embedded Developer accounts gain access to the following features:

  • Customize flows to partners’ preferred branding.
  • Create demo partner managed companies. Partner managed companies are not managed by Gusto - they’re companies managed by the partner themselves.

Steps for New Accounts

  1. Go to dev.gusto.com.
  2. Click “Sign Up” on the top right of the page.
  3. Under “Are you building embedded payroll?”, click “Yes”.
  4. Fill out the form with your information and submit. Your newly created account should now be configured as an Embedded Developer account!

📘

Dev Accounts for Embedded Partners were launched September 2022.

If you created an account before this time, you can update your account to an Embedded one by following these steps:

  1. Go to dev.gusto.com and login.
  2. Click the “Account” link on the top right of the page.
  3. Under “Are you building embedded payroll?”, click “Yes”.
  4. Confirm your current password before submitting the form. Your account should now be configured as an Embedded Developer account!

Once you’ve created an account and completed your Organization setup, you will have access to your unique API token from the Organizations tab, which is used to create a Gusto account that you can manage. Creating a Gusto account is the first step in creating and onboarding a company and its employees, and ultimately, running payroll.

Next, you can create an Application to obtain API credentials – or “keys” – to access our demo environment (https://api.gusto-demo.com). The application will generate a unique client_id and secret to be used for authentication via OAuth2.

You can invite team members to join your developer account, too. This is done from the Organizations tab under Team.


What’s Next