Create a contractor payment group

post

https://api.gusto-demo.com/v1/companies/{company_id}/contractor_payment_groups

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

scope: payrolls:run

Path Params

company_id

string

required

The UUID of the company

Body Params

check_date

date

required

The payment check date

creation_token

string

required

Required token used to make contractor payment group creation idempotent. String must be unique for each group you intend to create.

submission_blockers

array of objects

Optional array of submission blockers with selected unblock options. Returned from the preview endpoint and can be submitted with selected_option to resolve blockers.

submission_blockers

contractor_payments

array of objects

required

contractor_payments*

Headers

X-Gusto-API-Version

string

enum

Defaults to 2026-02-01

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Allowed:

Responses

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Full contractor payment group object

404Not Found The requested company does not exist. Make sure the provided UUID is valid.

422Unprocessable Entity This may happen when the body of your request contains errors such as invalid_attribute_value, or the request fails due to an invalid_operation. See the Errors Categories guide for more details.