These docs are for v2024-03-01. Click to read the latest docs for v2026-02-01.

Create a contractor payment

post

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

Pay a contractor. 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

contractor_uuid

string

required

The contractor receiving the payment

date

required

Date of contractor payment

payment_method

string

enum

Defaults to Direct Deposit

Allowed:

wage

number

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

hours

number

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

bonus

number

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

reimbursement

number

Reimbursed wages for the contractor

Headers

X-Gusto-API-Version

string

enum

Defaults to 2024-03-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

404

Not Found

The requested resource does not exist. Make sure the provided UUID is valid.

Language

Credentials

Bearer

Loading…

Response

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

application/json

200Example response

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.