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.

📘 Token Authentication

this endpoint uses the organization level api token and the Token scheme with HTTP Authorization header

Request Body

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

HEADERS

KeyDatatypeRequiredDescription
X-Gusto-API-VersionstringDetermines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.
Content-Typestring
Acceptstring

RESPONSES

status: OK

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