Update a contractor

PUT {{baseUrl}}/v1/contractors/:contractor_id

Update a contractor.

scope: contractors:write

🚧 Warning

Watch out when changing a contractor's type (when the contractor is finished onboarding). Specifically, changing contractor type can be dangerous since Gusto won’t recognize and file two separate 1099s if they simply change from business to individual

Request Body

{"version"=>"<string>", "type"=>"Individual", "wage_type"=>"<string>", "start_date"=>"<string>", "hourly_rate"=>"<string>", "self_onboarding"=>false, "email"=>"<string>", "first_name"=>"<string>", "last_name"=>"<string>", "middle_initial"=>"<string>", "file_new_hire_report"=>false, "work_state"=>"<string>", "ssn"=>"<string>", "business_name"=>"<string>", "ein"=>"<string>", "is_active"=>"<boolean>"}

HEADERS

KeyDatatypeRequiredDescription
X-Gusto-API-VersionstringDetermines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;uuid&quot;:&quot;c9fc1ad3-c107-4e7b-aa21-2dd4b00a7a07&quot;,&quot;company_uuid&quot;:&quot;b7457fec-3b76-43bb-9c6e-69cca4688942&quot;,&quot;wage_type&quot;:&quot;Hourly&quot;,&quot;start_date&quot;:&quot;2022-01-01&quot;,&quot;is_active&quot;:false,&quot;version&quot;:&quot;63859768485e218ccf8a449bb60f14ed&quot;,&quot;type&quot;:&quot;Individual&quot;,&quot;first_name&quot;:&quot;Kory&quot;,&quot;last_name&quot;:&quot;Gottlieb&quot;,&quot;middle_initial&quot;:&quot;P&quot;,&quot;business_name&quot;:null,&quot;ein&quot;:null,&quot;has_ein&quot;:false,&quot;has_ssn&quot;:true,&quot;department&quot;:&quot;Stage hand&quot;,&quot;department_uuid&quot;:&quot;56260b3d-c375-415c-b77a-75d99f717193&quot;,&quot;email&quot;:&quot;keira.west@mckenzie.org&quot;,&quot;file_new_hire_report&quot;:true,&quot;work_state&quot;:&quot;FL&quot;,&quot;onboarded&quot;:true,&quot;onboarding_status&quot;:&quot;onboarding_completed&quot;,&quot;address&quot;:{&quot;street_1&quot;:&quot;621 Jast Row&quot;,&quot;street_2&quot;:&quot;Apt. 281&quot;,&quot;city&quot;:&quot;Coral Springs&quot;,&quot;state&quot;:&quot;FL&quot;,&quot;zip&quot;:&quot;33065&quot;,&quot;country&quot;:&quot;USA&quot;},&quot;hourly_rate&quot;:&quot;60.00&quot;}