Skip to main content

Documentation Index

Fetch the complete documentation index at: https://gusto-preview.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Welcome to the Gusto Developer Docs

Build payroll and HR solutions faster with our comprehensive API, React SDK, and pre-built Flows. Get started in minutes.

Gusto Developer Docs

Quick Start

Get up and running with Gusto Embedded Payroll in a few steps.

1

Get your API credentials

Sign in to the Developer Portal to create an application and obtain your client_id and client_secret.
2

Obtain a system access token

Request a system access token to perform application-level actions like creating companies.
cURL
curl --request POST 'https://api.gusto-demo.com/oauth/token' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "client_id": "{{client_id}}",
    "client_secret": "{{client_secret}}",
    "grant_type": "system_access"
  }'
3

Make your first API call

Include the X-Gusto-API-Version header to specify your API version.
cURL
curl --request GET \
  --url https://api.gusto-demo.com/v1/me \
  --header 'Authorization: Bearer {ACCESS_TOKEN}' \
  --header 'X-Gusto-API-Version: 2024-04-01'
4

Create a company

Use your system access token to create a partner managed company and start building your payroll integration. See Companies for details.

Choose Your Build Path

Build with Gusto Embedded Payroll or integrate through App Integrations. Choose the right approach based on your customization needs and use case.

Gusto Embedded Payroll

Build your own in-app payroll solution with Gusto’s API, React SDK, or pre-built Flows. Customize the experience for your users’ needs.

App Integrations

Integrate your application with Gusto to solve critical pain points and create a seamless experience for mutual customers.

Popular Guides

Essential documentation to help you understand and implement payroll features.

Payroll Fundamentals

Payroll Fundamentals

Understand companies, employees, pay periods, and money movement.

Read guide
Companies

Companies

Learn how to create and manage partner-managed companies.

Read guide
Idempotency

Idempotency

Ensure safe retries and prevent duplicate operations.

Read guide
System Access Tokens

System Access Tokens

Authenticate for application-level API actions.

Read guide

Resources

Everything you need to build and stay up to date.

API Reference

Browse all API endpoints, request/response schemas, and examples.

What's New

See the latest features and changes in the current API version.

Start building with Gusto today.

Access comprehensive API documentation, code examples, guides, and everything you need to integrate payroll and HR functionality into your application.

Get started