v1

latestOpenAPI 3.1.02026-07-243113441.2 MB

Contractor Payment Groups

Create a contractor payment group

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

scope: payrolls:run

post/v1/companies/{company_id}/contractor_payment_groups

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

check_datestring date required

The payment check date

creation_tokenstring required

A token used to make contractor payment group creation idempotent. The string must be unique for each group you intend to create.

Example request

{
  "check_date": "2020-01-01",
  "creation_token": "1d532d13-8f61-4a57-ad3c-b5fac1c6e05e",
  "contractor_payments": [
    {
      "wage": "5000.0",
      "hours": "40.0",
      "bonus": "500.0",
      "reimbursement": "20.0",
      "invoice_number": "INV-001",
      "memo": "Payment for consulting services"
    }
  ]
}

Response

Full contractor payment group object

uuidstring

The unique identifier of the contractor payment group.

company_uuidstring

The UUID of the company.

check_datestring

The check date of the contractor payment group.

debit_datestring

The debit date of the contractor payment group.

status'Unfunded' | 'Funded'

The status of the contractor payment group. Will be Funded if all payments that should be funded (i.e. have Direct Deposit for payment method) are funded. A group can have status Funded while having associated payments that have status Unfunded, i.e. payment with Check payment method.

creation_tokenstring nullable

Token used to make contractor payment group creation idempotent. Will error if attempting to create a group with a duplicate token.

partner_owned_disbursementboolean nullable

Whether the disbursement is partner owned.