Sign in

v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Contractor Payments

Create a contractor payment

Pay a contractor. Information needed depends on the contractor's wage type (hourly vs fixed)

scope: payrolls:run

post/v1/companies/{company_id}/contractor_payments

Path parameters

company_idstring 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.

Request body

contractor_uuidstring required

The contractor receiving the payment.

datestring date required

Date of contractor payment.

payment_method'Direct Deposit' | 'Check' | 'Historical Payment'
wagestring float

If the contractor is on a fixed wage, this is the fixed wage payment for the contractor, regardless of hours worked.

hoursstring float

If the contractor is on an hourly wage, this is the number of hours that the contractor worked for the payment.

bonusstring float

If the contractor is on an hourly wage, this is the bonus the contractor earned.

reimbursementstring float

Reimbursed wages for the contractor.

invoice_numberstring

An optional invoice number to associate with this contractor payment. This will be visible to the contractor on their paystub. Maximum 25 characters.

memostring

An optional note or memo for this contractor payment. This will be visible to the contractor on their paystub.

Example request

{
  "date": "2020-01-01",
  "wage": "5000",
  "hours": "40",
  "bonus": "500",
  "reimbursement": "20",
  "invoice_number": "INV-001",
  "memo": "Payment for consulting services"
}

Response

successful

uuidstring required

The unique identifier of the contractor payment in Gusto.

contractor_uuidstring

The UUID of the contractor.

bonusstring float

The bonus amount in the payment.

datestring

The payment date.

hoursstring float

The number of hours worked for the payment.

payment_method'Direct Deposit' | 'Check' | 'Historical Payment' | 'Correction Payment'

The payment method.

reimbursementstring float

The reimbursement amount in the payment.

status'Funded' | 'Unfunded'

Contractor payment status

hourly_ratestring float

The rate per hour worked for the payment.

may_cancelboolean

Determine if the contractor payment can be cancelled.

wagestring float

The fixed wage of the payment, regardless of hours worked.

wage_type'Hourly' | 'Fixed'

The wage type for the payment.

wage_totalstring float

(hours * hourly_rate) + wage + bonus

invoice_numberstring nullable

An optional invoice number associated with this contractor payment. This will be visible to the contractor on their paystub. Maximum 25 characters.

memostring nullable

An optional note or memo for this contractor payment. This will be visible to the contractor on their paystub.