Update a contractor

patch

https://sandbox.checkhq.com/contractors/{contractor}

Updates the specified contractor.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

contractor

string

required

ID of the contractor to update

Body Params

type

string

If the contractor is a person set to "individual", otherwise set to "business".

first_name

string

Contractor's first name

middle_name

string

Contractor's middle name

last_name

string

Contractor's last name

business_name

string

Contractor's business name if they are a business

dob

date

Contractor's date of birth

start_date

date

Most recent start date of contract. To cancel a contractor who never started, see Start and termination dates.

termination_date

date

Most recent termination date of contract. Must be null, or on or after start_date, which must be set. To rehire, send termination_date: null with the new start_date. See Start and termination dates.

workplaces

array of strings

IDs of workplaces where the contractor works

workplaces

primary_workplace

string

The Workplace ID of the contractor's primary workplace.

string

Contractor's email address

ssn

string

Contractor's TIN (usually their Social Security Number). Must be unique across all contractors in a company. Only the last four digits of an SSN will be made available in ssn_last_four after being set.

ein

string

Contractor's Employer Identification Number, if applicable

default_net_pay_split

string

ID of contractor's net pay split

address

object

Contractor's address

mailing_address

object | null

Mailing address for paper correspondence. Separate from the contractor's legal address and not used for tax calculations. Pass null to clear. When creating a new mailing address, line1, city, state, and postal_code are required.

1099_nec_electronic_consent_provided

boolean

Defaults to false

Indicates whether the contractor has opted into electronic delivery of Copy B of 1099-NEC.

metadata

json

Additional loosely structured information to associate with the contractor

Responses

200200

400400