--- title: "Add a requisition" method: POST path: "/requisitions" tags: ["Requisition API:Requisitions"] --- # Add a requisition `POST /requisitions` ## Request body - AddRequisitionCommand - `contactId` integer, required — Hiring manager (contact) submitting the requisition. - `jobTitle` string, nullable, required - `jobDescription` string, nullable - `category` SubmitCategoryModel - `categoryId` integer, required - `subCategoryId` integer, nullable - `location` SubmitLocationModel - `locationId` integer, required - `areaId` integer, nullable - `workplaceAddressId` string, uuid, nullable — Workplace address Id - `start` SubmitJobOrderStartModel - `immediate` boolean - `relative` SubmitRelativeStartModel - `period` integer - `unit` 'Week' | 'Month', string - `date` string, date, nullable — The specific date that the job starts - `duration` SubmitDurationModel - `period` integer - `unit` 'Hour' | 'Day' | 'Week' | 'Month', string - `workTypeId` integer, nullable - `salary` SubmitJobOrderSalaryRangeModel - `ratePer` 'Hour' | 'Day' | 'Week' | 'Month' | 'Year', string - `rateLow` number, double - `rateHigh` number, double, nullable - `currency` string, nullable — Optional ISO 4217 3-letter alphabetic currency code - `timePerWeek` number, double, nullable — Number of days per week for a daily rate, hours per day for an hourly rate with a 'Day' duration unit or hours per day for an hourly rate with a 'Week' duration unit. - `numberOfJobs` integer - `source` string, nullable - `custom` SubmitCustomFieldValueModel[], nullable - `fieldId` integer, required - `value` unknown - `workflowId` integer, nullable - `recruiterUserId` integer[], nullable — User Id - Optional list of recruiters assigned to the requisition. - `formID` integer, nullable ## Response `201` Created - RequisitionRepresentation - `requisitionId` integer, required - `status` 'Draft' | 'Submitted' | 'Rejected' | 'Approved' | 'Closed', string - `workflowStageIndex` integer, nullable - `jobTitle` string, required - `jobOrderId` integer, nullable - `company` CompanyNameModel - `companyId` integer, required — Unique identifier for the company - `name` string, nullable — Company name - `status` StatusModel - `statusId` integer, required - `name` string, required - `active` boolean - `default` boolean - `owner` UserNameModel - `userId` integer, required - `firstName` string, nullable - `lastName` string, nullable - `position` string, nullable - `email` string, nullable - `phone` string, nullable - `mobile` string, nullable - `inactive` boolean - `deleted` boolean - `hiringManager` ContactNameModel - `contactId` integer, required — Unique identifier for the contact - `firstName` string, nullable — First name - `lastName` string, nullable — Last name - `position` string, nullable — Position or job title - `salutation` string, nullable — Salutation/honorific/title - `unsubscribed` boolean - `email` string, nullable — Primary email address - `phone` string, nullable — Phone number - `mobile` string, nullable — Mobile/cell number - `mobileNormalized` string, nullable — Mobile/cell normalized number - `inactive` boolean — Contact is no longer with the company - `status` StatusModel - `statusId` integer, required - `name` string, required - `active` boolean - `default` boolean - `owner` UserNameModel - `userId` integer, required - `firstName` string, nullable - `lastName` string, nullable - `position` string, nullable - `email` string, nullable - `phone` string, nullable - `mobile` string, nullable - `inactive` boolean - `deleted` boolean - `createdAt` string, date-time, nullable - `updatedAt` string, date-time, nullable - `workflow` CompanyWorkflowModel - `workflowId` integer, required - `name` string, required - `archived` boolean - `approvers` CompanyWorkflowApproverModel[], nullable - `stageIndex` integer, required - `contactId` integer, required — Unique identifier for the contact - `firstName` string, nullable — First name - `lastName` string, nullable — Last name - `position` string, nullable — Position or job title - `salutation` string, nullable — Salutation/honorific/title - `unsubscribed` boolean - `email` string, nullable — Primary email address - `phone` string, nullable — Phone number - `mobile` string, nullable — Mobile/cell number - `mobileNormalized` string, nullable — Mobile/cell normalized number - `inactive` boolean — Contact is no longer with the company - `status` StatusModel - `statusId` integer, required - `name` string, required - `active` boolean - `default` boolean - `owner` UserNameModel - `userId` integer, required - `firstName` string, nullable - `lastName` string, nullable - `position` string, nullable - `email` string, nullable - `phone` string, nullable - `mobile` string, nullable - `inactive` boolean - `deleted` boolean - `jobDescription` string, nullable - `numberOfJobs` integer - `source` string, nullable — Source of the requisition, or reason the requisition is being raised. - `workplaceAddress` CompanyAddressModel - `addressId` string, uuid, required - `name` string, nullable - `street` string[], nullable - `city` string, nullable - `state` string, nullable - `postalCode` string, nullable - `country` string, nullable - `countryCode` string, nullable - `phone` string, nullable - `fax` string, nullable - `url` string, uri, nullable - `category` JobOrderCategoryModel - `categoryId` integer, required - `name` string, required - `subCategory` JobOrderSubCategoryModel - `subCategoryId` integer, required - `name` string, required - `location` JobOrderLocationModel - `locationId` integer, required - `name` string, required - `area` JobOrderLocationAreaModel - `areaId` integer, required - `name` string, required - `start` JobOrderStartModel - `immediate` boolean - `relative` RelativeStartModel - `period` integer - `unit` 'Week' | 'Month', string - `date` string, date, nullable — The specific date that a job starts or a candidate is available - `duration` DurationModel - `period` integer - `unit` 'Hour' | 'Day' | 'Week' | 'Month', string - `workType` WorkTypeModel - `workTypeId` integer, required - `name` string, required - `ratePer` 'Hour' | 'Day' | 'Week' | 'Month' | 'Year', string - `salary` JobOrderSalaryRangeModel - `ratePer` 'Hour' | 'Day' | 'Week' | 'Month' | 'Year', string - `rateLow` number, double, nullable - `rateHigh` number, double, nullable - `currency` string, nullable — Optional ISO 4217 3-letter alphabetic currency code - `timePerWeek` number, double, nullable — Number of days per week for a daily rate or hours per week for an hourly rate. - `custom` CustomFieldValueModel[], nullable - `fieldId` integer, required - `name` string, required - `type` 'Text' | 'List' | 'Date' | 'Lookup' | 'Url', string, required — The type of value a custom field expects - `value` unknown - `owner` UserNameModel - `userId` integer, required - `firstName` string, nullable - `lastName` string, nullable - `position` string, nullable - `email` string, nullable - `phone` string, nullable - `mobile` string, nullable - `inactive` boolean - `deleted` boolean - `recruiters` UserNameModel[], nullable - `userId` integer, required - `firstName` string, nullable - `lastName` string, nullable - `position` string, nullable - `email` string, nullable - `phone` string, nullable - `mobile` string, nullable - `inactive` boolean - `deleted` boolean - `formID` integer, nullable - `links` RequisitionLinks - `self` string, uri, nullable - `workflow` string, uri, nullable - `job` string, uri, nullable — Link to job created for an approved requisition - `history` string, uri, nullable — Link to requisition approval history - `notes` string, uri, nullable — Notes --- [API](https://skmtc.net/jobadder/apis/jobadder-api.md) · [All operations](https://skmtc.net/jobadder/apis/jobadder-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jobadder/jobadder-api/revisions/9f43f6a6ee6e/schema)