Create a partner managed company

This endpoint is intended for Gusto Embedded Payroll customers. Please apply for early access if you’d like to learn more and use it for production. Note, this endpoint will require you to enter a different agreement with Gusto.


The partner managed company API provides a way to create a Gusto company that you can manage. This endpoint behaves similarly to creating a company in that it 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.

Additionally, on successful creation of the company, this API will do the following:

  • Creates a link between the partner and the company.
  • Creates access tokens and refresh tokens that can be used immediately.

In the response, you will receive the access token, the refresh token, and the uuid of the created company.


Due to the nature of this endpoint, Gusto will provide partners with an API token and will permit partners to use API Token Authentication instead of OAuth to provision Gusto accounts. The API token is included in the authorization HTTP header with the Token scheme, e.g.:

Content-Type: application/json
Authorization: Token bbb286ff1a4fe6b84742b0d49b8d0d65bd0208d27d3d50333591df71
Click Try It! to start a request and see the response here!