Create a contractor

post

https://sandbox.checkhq.com/contractors

Creates a contractor.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

company

string

required

ID of the company the contractor performs work for

type

string

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

first_name

string

Contractor's first name. If contractor type is business, a primary contact is needed for 1099 filing so use the first name of the business's primary contact.

middle_name

string

Contractor's middle name. If contractor type is business, a primary contact is needed for 1099 filing so use the middle name of the business's primary contact.

last_name

string

required

Contractor's last name. If contractor type is business, a primary contact is needed for 1099 filing so use the last name of the business's primary contact.

business_name

string

Contractor's business name if they're not an individual.

dob

date

Contractor's date of birth

start_date

date

Most recent start date of contract

termination_date

date

Most recent termination date of contract. Will be set to null if a more recent start date is set.

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

payment_method_preference

string

Either "direct_deposit" or "manual", default null

address

object

Contractor's address

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

Language

Credentials

Header

Loading…

Response

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

application/json

200200

400400