v2023-09-01 is in the deprecation process and all prior versions have been deprecated. Click this banner to review our version upgrade guide.

Create a partner managed company

post https://api.gusto-demo.com/v1/partner_managed_companies

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

Responses

401

Authorization information is missing or invalid.

`invalid_attribute_value`, or the request fails due to an `invalid_operation`. See the Errors Categories guide for more details.

Language

Credentials

Bearer


xxxxxxxxxx
1
curl --request POST \
2
     --url https://api.gusto-demo.com/v1/partner_managed_companies \
3
     --header 'X-Gusto-API-Version: 2024-04-01' \
4
     --header 'accept: application/json' \
5
     --header 'content-type: application/json'


xxxxxxxxxx
 
1
{
2
  "access_token": "de6780bc506a0446309bd9362820ba8aed28aa506c71eedbe1c5c4f9dd350e54",
3
  "refresh_token": "8257e65c97202ed1726cf9571600918f3bffb2544b26e00a61df9897668c33a1",
4
  "company_uuid": "d525dd21-ba6e-482c-be15-c2c7237f1364",
5
  "expires_in": 7200
6
}

200OK

422Unprocessable Entity This may happen when the body of your request contains errors such as invalid_attribute_value, or the request fails due to an invalid_operation. See the Errors Categories guide for more details.

`invalid_attribute_value`, or the request fails due to an `invalid_operation`. See the Errors Categories guide for more details.