GuidesAPI ReferenceChangelogAPI PolicyAPI StatusGusto Security

Onboarding Contractors

The add_contractors Flow is a feature that enables a payroll admin to fill out all necessary information for paying US based 1099 contractors. Learn more about Contractors here.

curl --request POST \
  --url https://api.gusto-demo.com/v1/companies/{{company_uuid}}/flows \
  --header 'Authorization: Bearer {{access_token}}’' \
  --header 'Content-Type: application/json' \
  --data '{
  "flow_type": "add_contractors"
}'

This flow is separate from the company_onboarding flows. Flows can only be stitched together if they share the same category. Reference the documentation at this link to see which category each flow belongs to.

Flows can be used on their own or in conjunction with our APIs if you already have UI to collect payroll pertinent information. For example, if you already collect some data for Contractors, you can pass this information via API and this will pre-fill the Flow so your end user can review the information in the Flow and complete any outstanding data.

Any contractors added before generating the Flow will appear in the list of Contractors on the first page:

Adding contractors

The employer will fill out these steps for onboarding contractors:

  • Personal details of contractor (e.g., rate, name)
  • Mailing address or business address of contractor
  • Payment details for contractor
  • New hire report for contractor (optional)
  • Summary page

Payment details

An employer has the option to pay contractors via check or direct deposit through a bank account. If a physical check is selected as the preferred payment method the employer will be responsible for the creation and transmission of the checks every payday, we will tell you the exact amount to pay.

New Hire Report

An employer can either file the new hire report themselves or let Gusto take care of it behind the scenes by selecting β€œYes, file the report for me” and selecting the state the contractor will be performing the work in after the contractor has completed onboarding.

Completing onboarding

After all information is entered and reviewed the employer will update the contractor’s onboarding status to onboarding_completed.

Delete a contractor

We can remove the contractor in the contractors list page. Once you’ve paid a contractor you will not be able to delete them.

Post Onboarding

This contractor management Flow can be recalled at any time for the employer to edit information for contractors after initial onboarding is complete.

❗️

Editing Post-Onboarding

The ability to edit a contractor’s type (e.g. Individual/Business) and new hire report after completing onboarding is restricted via the pre-built flows.