Create a partner managed company

POST {{baseUrl}}/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

Request Body

{"user"=>{"first_name"=>"<string>", "last_name"=>"<string>", "email"=>"<string>", "phone"=>"<string>"}, "company"=>{"name"=>"<string>", "trade_name"=>"<string>", "ein"=>"<string>", "contractor_only"=>"<boolean>"}}

HEADERS

RESPONSES

status: OK

{"access_token":"de6780bc506a0446309bd9362820ba8aed28aa506c71eedbe1c5c4f9dd350e54","refresh_token":"8257e65c97202ed1726cf9571600918f3bffb2544b26e00a61df9897668c33a1","company_uuid":"d525dd21-ba6e-482c-be15-c2c7237f1364","expires_in":7200}