GuidesAPI ReferenceChangelogAPI StatusAPI PolicyGusto Security
API Reference

Create a partner managed company

Create a partner managed company. When you successfully call the API, it does the following:

  • Creates a new company in Gusto
  • Creates a new user using the provided email if the user does not already exist.
  • Makes the user the primary payroll administrator of the new company.

In response, you will receive oauth access tokens for the created company.

IMPORTANT: the returned access and refresh tokens are reserved for this company only. They cannot be used to access other companies AND previously granted tokens cannot be used to access this company.

System Access Authentication

this endpoint uses the Bearer Auth scheme with the system-level access token in the HTTP Authorization header

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