GuidesAPI ReferenceChangelogAPI PolicyAPI StatusGusto Security

Change the contractor's onboarding status

Updates a contractor's onboarding status.

scope: contractors:write

Below is a list of valid onboarding status changes depending on the intended action to be performed on behalf of the contractor.

Actioncurrent onboarding_statusnew onboarding_status
Mark a contractor as self-onboardingadmin_onboarding_incompleteself_onboarding_not_invited
Invite an employee to self-onboardadmin_onboarding_incomplete or self_onboarding_not_invitedself_onboarding_invited
Cancel an employee's self-onboardingself_onboarding_invited or self_onboarding_not_invitedadmin_onboarding_incomplete
Review an employee's self-onboarded infoself_onboarding_startedself_onboarding_review
Finish an employee's onboardingadmin_onboarding_incomplete or self_onboarding_reviewonboarding_completed

📘

When contractor is fully onboarded
The new hire report will be generated using the current data (work_state) (if contractor file_new_hire_report is set true)

Language
Authorization
Bearer
URL
Click Try It! to start a request and see the response here!