v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Companies

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

scope: partner_managed_companies:manage

post/v1/partner_managed_companies

Headers

X-Gusto-API-Version'2026-06-15'

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

Request body

Response

OK

access_tokenstring

Access token that can be used for OAuth access to the account. Access tokens expire 2 hours after they are issued.

refresh_tokenstring

Refresh token that can be exchanged for a new access token.

company_uuidstring

Gusto's UUID for the company

expires_ininteger

Time of access_token expiration in seconds