Update an external payroll

PUT {{baseUrl}}/v1/companies/:company_uuid/external_payrolls/:external_payroll_id

Update an external payroll with a list of external payroll items

scope: external_payrolls:write

Request Body

{"replace_fields"=>"<boolean>", "external_payroll_items"=>[{"employee_uuid"=>"<string>", "earnings"=>[{"hours"=>"<string>", "amount"=>"<string>", "earning_id"=>"<integer>", "earning_type"=>"<string>"}, {"hours"=>"<string>", "amount"=>"<string>", "earning_id"=>"<integer>", "earning_type"=>"<string>"}], "benefits"=>[{"company_contribution_amount"=>"<string>", "employee_deduction_amount"=>"<string>", "benefit_id"=>"<integer>"}, {"company_contribution_amount"=>"<string>", "employee_deduction_amount"=>"<string>", "benefit_id"=>"<integer>"}], "taxes"=>[{"amount"=>"<string>", "tax_id"=>"<integer>"}, {"amount"=>"<string>", "tax_id"=>"<integer>"}]}, {"employee_uuid"=>"<string>", "earnings"=>[{"hours"=>"<string>", "amount"=>"<string>", "earning_id"=>"<integer>", "earning_type"=>"<string>"}, {"hours"=>"<string>", "amount"=>"<string>", "earning_id"=>"<integer>", "earning_type"=>"<string>"}], "benefits"=>[{"company_contribution_amount"=>"<string>", "employee_deduction_amount"=>"<string>", "benefit_id"=>"<integer>"}, {"company_contribution_amount"=>"<string>", "employee_deduction_amount"=>"<string>", "benefit_id"=>"<integer>"}], "taxes"=>[{"amount"=>"<string>", "tax_id"=>"<integer>"}, {"amount"=>"<string>", "tax_id"=>"<integer>"}]}]}

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;c5fdae57-5483-4529-9aae-f0edceed92d4&quot;,&quot;company_uuid&quot;:&quot;bcb305b0-2855-4025-8d22-e484a9e6b7c9&quot;,&quot;check_date&quot;:&quot;2022-06-03&quot;,&quot;payment_period_start_date&quot;:&quot;2022-05-15&quot;,&quot;payment_period_end_date&quot;:&quot;2022-05-30&quot;,&quot;status&quot;:&quot;unprocessed&quot;,&quot;external_payroll_items&quot;:[{&quot;employee_uuid&quot;:&quot;44f7cba9-7a3d-4f08-b7bd-6fcf5211f8ca&quot;,&quot;earnings&quot;:[{&quot;amount&quot;:10000,&quot;hours&quot;:0,&quot;earning_type&quot;:&quot;CompanyPayType&quot;,&quot;earning_id&quot;:1},{&quot;amount&quot;:500,&quot;hours&quot;:0,&quot;earning_type&quot;:&quot;CompanyEarningType&quot;,&quot;earning_id&quot;:4}],&quot;benefits&quot;:[{&quot;benefit_id&quot;:22,&quot;company_contribution_amount&quot;:100,&quot;employee_deduction_amount&quot;:50},{&quot;benefit_id&quot;:25,&quot;company_contribution_amount&quot;:0,&quot;employee_deduction_amount&quot;:300}],&quot;taxes&quot;:[{&quot;tax_id&quot;:1,&quot;amount&quot;:400},{&quot;tax_id&quot;:2,&quot;amount&quot;:60}]}],&quot;applicable_earnings&quot;:[{&quot;earning_type&quot;:&quot;CompanyPayType&quot;,&quot;earning_id&quot;:1,&quot;name&quot;:&quot;Regular Wages&quot;,&quot;input_type&quot;:&quot;amount&quot;,&quot;category&quot;:&quot;default&quot;},{&quot;earning_type&quot;:&quot;CompanyEarningType&quot;,&quot;earning_id&quot;:4,&quot;name&quot;:&quot;Cash Tips&quot;,&quot;input_type&quot;:&quot;amount&quot;,&quot;category&quot;:&quot;default&quot;}],&quot;applicable_benefits&quot;:[{&quot;id&quot;:22,&quot;description&quot;:&quot;Kaiser&quot;,&quot;active&quot;:true},{&quot;id&quot;:25,&quot;description&quot;:&quot;HSA&quot;,&quot;active&quot;:true}],&quot;applicable_taxes&quot;:[{&quot;id&quot;:1,&quot;name&quot;:&quot;Federal Income Tax&quot;,&quot;employer_tax&quot;:false,&quot;resident_tax&quot;:false},{&quot;id&quot;:2,&quot;name&quot;:&quot;Social Security&quot;,&quot;employer_tax&quot;:false,&quot;resident_tax&quot;:false}],&quot;metadata&quot;:{&quot;deletable&quot;:true}}