Create a Company and Authenticate

Embedded payroll begins with the creation of a company that you can manage. You’ll use the partner managed company endpoint to:

  • Create a new company in Gusto
  • Create a new user in Gusto
  • Make the new user the primary payroll administrator of the new 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 OAuth2 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

You will need the user’s first_name, last_name, email, and company_name in order to make this request.

Upon successful creation of the company, this creates a link between you (the partner) and the company. In the API response you will receive the access_token, refresh_token, and uuid of the company created. The access_token and refresh _token can be used immediately.

Did this page help you?