---
title: "Create a job"
method: POST
path: "/jobs"
tags: ["Jobs"]
---

# Create a job

`POST /jobs`

## Request

- Base URL: `https://api.intellihr.io`
- URL: `https://api.intellihr.io/jobs`
- Auth: API key in header `Authorization`

Create a job for a Person. 

IMPORTANT: Please note that workflows will NOT be automatically triggered as a result of creating Jobs using this API endpoint. 

To trigger the workflows manually, use the intelliHR platform. 

Automatic workflow triggering will be added in the future, please contact <a href="mailto:support@intellihr.co">support@intellihr.co</a> with any questions.

## Request body

- JobsCreate
  - `businessEntityId` ResourceId, required (unresolved $ref)
  - `businessUnitId` ResourceId, required (unresolved $ref)
  - `createdAt` CreatedAt (unresolved $ref)
  - `currency` Currency (unresolved $ref)
  - `endDate` RfcDateTime (unresolved $ref)
  - `fte` unknown
  - `isEndDateConfirmed` boolean
  - `leave` Leave[]: An array of Leave entries linked to this [Job](#tag/Jobs) (unresolved $ref)
  - `locationId` ResourceId (unresolved $ref)
  - `name` string, required
  - `payGrade` string
  - `personId` ResourceId, required (unresolved $ref)
  - `recruitmentCost` unknown
  - `source` string
  - `startDate` RfcDateTime, required (unresolved $ref)
  - `status` string
  - `supervisorId` ResourceId (unresolved $ref)
  - `updatedAt` UpdatedAt (unresolved $ref)
  - `workClassId` ResourceId, required (unresolved $ref)
  - `workTypeId` ResourceId, required (unresolved $ref)

## Response `201`

Created Successfully

- Jobs
  - `data` object
    - `type` 'jobs'
    - `id` ResourceId (unresolved $ref)
    - `attributes` object
      - `startDate` RfcDateTime (unresolved $ref)
      - `endDate` RfcDateTime (unresolved $ref)
      - `isEndDateConfirmed` boolean
      - `name` string
      - `businessUnit` string
      - `businessEntity` string
      - `status` string
      - `workType` string
      - `workClass` string
      - `payGrade` string
      - `fte` unknown
      - `supervisorId` ResourceId (unresolved $ref)
      - `currency` Currency (unresolved $ref)
      - `recruitmentCost` unknown
      - `source` string
      - `leave` Leave[]: An array of Leave entries linked to this [Job](#tag/Jobs) (unresolved $ref)
      - `location` object
        - `name` string
        - `address` string
      - `personId` ResourceId (unresolved $ref)
      - `createdAt` CreatedAt (unresolved $ref)
      - `updatedAt` UpdatedAt (unresolved $ref)

## Other responses

- `400` (unresolved $ref)
- `403` (unresolved $ref)
- `500` (unresolved $ref)

---

[API](https://skmtc.dev/intellihr/apis/intellihr-public-api.md) · [All operations](https://skmtc.dev/intellihr/apis/intellihr-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/intellihr/apis/intellihr-public-api/revisions/6529279c999b?raw)