Contractor Payments

Due to their different tax treatments, 1099 Contractor payments are handled separately from W2 Employee payroll and off-cycle payroll.

The instructions below assume that the application is already authenticated, and that the bearer token is being specified via the Authorization HTTP header.

Step-by-Step Instructions

Start with a POST request to the create a contractor payment endpoint to with the required parameters company_id_or_uuid, contractor_id, and date. The optional parameters bonus, hours, reimbursement, and wage can all be included depending on what needs to be paid to the contractor.

This request will return an object containing individual contractor payments, within a given time period, including totals. This will also return a unique contractor payment ID for the newly created payment (uuid)


Unlike payrolls, this POST request creates and processes the contractor payment in one step. There is no need to submit the payment.

To review the payment, use the uuid obtained in the previous step to call the get a single contractor payment endpoint and retrieve the payment details.

To view a Company's payments for a particular time period, use get contractor payments for a company and include the start_date and end_date parameters (option to use Pagination too).

Cancel a Contractor Payment

Similar to payrolls, a contractor payment can be canceled using the cancel a contractor payment endpoint. This DELETE request cancels and deletes a contractor payment.



Similar to W2 Employee payrolls, a Contractor payment cannot be canceled after 3:30pm PST on the payroll_deadline. If a customer needs to cancel a payroll after this time frame they will need to contact support.

Did this page help you?