Create a company

Overview

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

System Access Authentication

This endpoint uses the Bearer Auth scheme with the system-level access token in the 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 2026-02-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
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json