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
Key | Datatype | Required | Description |
---|---|---|---|
X-Gusto-API-Version | string | Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used. | |
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"access_token":"de6780bc506a0446309bd9362820ba8aed28aa506c71eedbe1c5c4f9dd350e54","refresh_token":"8257e65c97202ed1726cf9571600918f3bffb2544b26e00a61df9897668c33a1","company_uuid":"d525dd21-ba6e-482c-be15-c2c7237f1364","expires_in":7200}