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.

post/external/v2/contractor

Request

  • Base URL: https://api.getthera.com
  • URL: https://api.getthera.com/external/v2/contractor
  • Auth: API key in header X-Thera-API-Key

Request body

emailstring required
firstNamestring required
lastNamestring required
countrystring required
currencystring required
wageType'HOURLY' | 'DAILY' | 'MONTHLY' | 'SEMIMONTHLY' | 'BIWEEKLY' | 'WEEKLY' | 'MILESTONE' required
rateinteger

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.

contractType'FIXED_RATE' | 'FLEXIBLE_RATE' | 'MILESTONE' | 'TIME_TRACKING' required
contractNamestring required
contractDocumentType'NO_CONTRACT' | 'CONTRACT_WIZARD' required
companySigningAuthorityUserIdstring

The Thera User ID of signer from the company side. Must be an Admin or a Manager.

clientCanSubmitWorkboolean
workerCanSubmitWorkboolean
scopeOfWorkstring
teamIdstring

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

Response with status 200

successboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.