These docs are for v2024-03-01. Click to read the latest docs for v2026-06-15.

Create a company

The company provisioning API provides a way to create a Gusto company as part of your integration. When you successfully call the API, the API does the following:

  • Creates a new company in Gusto.
  • Creates a new user in Gusto.
  • Makes the new user the primary payroll administrator of the new company.
  • Sends a welcome email to the new user.
    In the response, you will receive an account claim URL. Redirect the user to this URL to complete their account setup inside of Gusto
📘

Token Authentication

This endpoint uses the organization level api token and the Token scheme with HTTP Authorization header.

scope: accounts:write

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
user
object
required

Information for the user who will be the primary payroll administrator for the new company.

company
object
required
Headers
string
enum
Defaults to 2024-03-01

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Allowed:
Responses

401

Authorization information is missing or invalid.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json