Create a contractor

Changed on

Creates a contractor.

post/contractors (COPY)

Request

Request body

companystring required

ID of the company the contractor performs work for

typestring

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

first_namestring

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_namestring

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_namestring 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_namestring

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

dobstring date

Contractor's date of birth

start_datestring date

Most recent start date of contract

termination_datestring date

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

workplacesstring[]

IDs of workplaces where the contractor works

primary_workplacestring

The Workplace ID of the contractor's primary workplace.

emailstring

Contractor's email address

ssnstring

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.

einstring

Contractor's Employer Identification Number, if applicable

default_net_pay_splitstring

ID of contractor's net pay split

payment_method_preferencestring

Either "direct_deposit" or "manual", default null

1099_nec_electronic_consent_providedboolean

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

metadatastring json

Additional loosely structured information to associate with the contractor

Response

200

object required

Changes