GUgusto
Companies

Finish company onboarding

Changed on

Finalize a company's onboarding process.

Approve a company in demo

After a company is finished onboarding, Gusto requires an additional step to review and approve that company. The company onboarding status is "onboarding_completed": false, until the API call is made to finish company onboarding. In production environments, this step is required for risk-analysis purposes.

We provide the endpoint PUT '/v1/companies/{company_uuid}/approve' to facilitate company approvals in the demo environment.

PUT '/v1/companies/89771af8-b964-472e-8064-554dfbcb56d9/approve'

# Response: Company object, with company_status: 'Approved'

scope: companies:write

put/v1/companies/{company_uuid}/finish_onboarding

Request

Path parameters

company_uuidstring required

The UUID of the company

Headers

X-Gusto-API-Version'2026-06-15'

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Response

Success

uuidstring required

the UUID of the company

onboarding_completedboolean

a boolean flag for the company's onboarding status

Changes