---
title: "Add a draft job ad"
method: POST
path: "/jobads"
tags: ["Job Ad API:Job Ads"]
---

# Add a draft job ad

`POST /jobads`

## Request body

- AddJobAdDraftCommand
  - `title` string, required
  - `reference` string, nullable
  - `summary` string, nullable
  - `bulletPoints` string[], nullable
  - `description` string, nullable
  - `jobId` integer — Associated job
  - `ownerUserId` integer, required

## Response `201`

Created

- JobAdRepresentation
  - `adId` integer, required
  - `state` string, nullable
  - `title` string, nullable
  - `reference` string, nullable
  - `summary` string, nullable
  - `bulletPoints` string[], nullable
  - `description` string, nullable
  - `job` JobOrderTitleModel
    - `jobId` integer, required
    - `jobTitle` string, nullable
    - `location` JobOrderLocationModel
      - `locationId` integer, required
      - `name` string, required
      - `area` JobOrderLocationAreaModel
        - `areaId` integer, required
        - `name` string, required
    - `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
    - `contact` 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
    - `status` StatusModel
      - `statusId` integer, required
      - `name` string, required
      - `active` boolean
      - `default` boolean
    - `source` string, nullable
    - `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
  - `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
  - `contact` 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
  - `screening` JobAdScreeningQuestionModel[], nullable
    - `question` string, nullable
    - `answerType` 'Text' | 'List', string
    - `mandatory` boolean, nullable — Field is mandatory and a value must be provided
    - `maxLength` integer, nullable — Maximum length of a text field
    - `multiSelect` boolean, nullable — List selection allows multiple values
    - `values` string[], nullable — List of predefined values to select from
  - `jobBoards` JobBoardSummaryModel[], nullable
    - `boardId` integer
    - `name` string, nullable
    - `reference` string, nullable
  - `otherApplyUrls` JobAdOtherApplyUrlModel[], nullable
    - `name` string, nullable
    - `url` string, nullable
  - `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
  - `createdBy` 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
  - `postAt` string, date-time, nullable
  - `expireAt` string, date-time, nullable
  - `partnerActions` PartnerActionStageModel[], nullable
    - `actionId` string, uuid
    - `actionName` string, nullable
    - `reference` string, nullable — Unique partner defined reference/identifier for the action
    - `stage` 'Submitted' | 'InProgress' | 'Completed' | 'Rejected' | 'Cancelled', string
    - `status` string, nullable — Partner defined progress status message for the action
    - `result` PartnerActionResultModel
      - `score` integer, nullable — Optional partner score for the action result
      - `url` string, uri, nullable — Optional partner defined URL for the action result
      - `urlType` 'Popup' | 'Page', string
    - `submittedAt` string, date-time
    - `submittedBy` 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
    - `updatedAt` string, date-time
    - `updatedBy` 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
  - `links` JobAdLinks
    - `self` string, uri, nullable
    - `job` string, uri, nullable — Job
    - `company` string, uri, nullable — Company
    - `contact` string, uri, nullable — Contact
    - `applications` string, uri, nullable — Job applications

---

[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)