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.

📘 Token Authentication

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

scope: partner_managed_companies:write

Request Body

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

HEADERS

KeyDatatypeRequiredDescription
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}