---
title: "Creates a new direct hire job"
method: POST
path: "/v{version}/DirectHires"
tags: ["DirectHires"]
---

# Creates a new direct hire job

`POST /v{version}/DirectHires`

## Path parameters

- `version` string, required

## Headers

- `company-id` string, required

## Request body

- DirectHiresContractsCommandsSaveDirectHireCommand
  - `companyId` string, uuid
  - `jobId` integer
  - `clientId` integer
  - `candidateName` string, nullable
  - `candidateTitle` string, nullable
  - `startDate` string, date-time
  - `candidateSalary` number, double
  - `contractId` integer, nullable
  - `fee` number, double
  - `creditDiscount` number, double
  - `creditDiscountNotes` string, nullable
  - `totalInvoiceAmount` number, double
  - `signOnBonus` number, double
  - `otherGPReduction` number, double
  - `reductionNotes` string, nullable
  - `totalGrossProfit` number, double
  - `remittanceId` integer, nullable
  - `addressId` integer, nullable
  - `mailInvoiceDate` string, date-time
  - `mailInvoiceToAddress` boolean
  - `invoiceMessage` string, nullable
  - `customFields` DirectHiresContractsCommandsCustomfield[], nullable
    - `customFieldId` integer
    - `customFieldValue` string, nullable
  - `contacts` DirectHiresContractsCommandsContact[], nullable
    - `contactId` integer
  - `invoiceSplits` DirectHiresContractsCommandsInvoicesplit[], nullable
    - `invoiceDate` string, date-time
    - `paymentTermId` integer, nullable
    - `amount` number, double
    - `isProcessed` boolean
    - `invoiceId` integer, nullable
  - `offerLetterFiles` string[], nullable

## Response `200`

Success

- DirectHiresContractsResponsesSaveDirectHireResponse
  - `isValid` boolean
  - `errors` string[], nullable
  - `warnings` string[], nullable
  - `info` string[], nullable
  - `message` string, nullable
  - `data` DirectHiresContractsModelsNewDirectHireResponse
    - `jobId` integer
    - `invoicesHandledCount` integer
    - `invoiceIdsReturned` integer[], nullable
    - `customFieldsHandledCount` integer
    - `emailContactsHandledCount` integer
    - `emailContactInsertsThatFailed` integer[], nullable
    - `offerLetterId` integer[], nullable

---

[API](https://skmtc.net/bilflo/apis/bilflo-api.md) · [All operations](https://skmtc.net/bilflo/apis/bilflo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bilflo/bilflo-api/revisions/bcdbca776df0/schema)