External API (Deprecated)Contractors

Create Contractor

Creates a contractor and their contract in a single call, for any contract type: fixed rate, flexible rate, milestone, or time tracking. The contractor is invited by email and becomes payable once they complete onboarding.

Authentication

X-Thera-API-Keystring
API Key authentication via header

Request

This endpoint expects an object.
emailstringRequired
firstNamestringRequired
lastNamestringRequired
countrystringRequired
currencystringRequired
wageTypeenumRequired
payCycleobjectRequired
contractTypeenumRequired
contractNamestringRequired
contractDocumentTypeenumRequired
verificationSettingobjectRequired
ratelongOptional

In the smallest unit possible. Minor Unit if exists, else use Major Unit. Adheres to ISO 4217 standard. This field is not needed for Milestone Contractors.

companySigningAuthorityUserIdstringOptional
The Thera User ID of signer from the company side. Must be an Admin or a Manager.
clientCanSubmitWorkbooleanOptional
workerCanSubmitWorkbooleanOptional
scopeOfWorkstringOptional
teamIdstringOptional

The team the contract is created under, from Get Teams. Required when your company has more than one team; optional when it has exactly one, which is then used automatically.

Response

This endpoint returns an object.
successboolean

Errors

400
Bad Request Error
401
Unauthorized Error
409
Conflict Error