---
title: "Create a new job ad"
method: POST
path: "/jobs/{jobId}/jobads"
tags: ["jobs"]
---

# Create a new job ad

`POST /jobs/{jobId}/jobads`

## Request body

- JobAdContent
  - `title` string, title, required
  - `language` JobAdLanguage
    - `code` 'af' | 'am' | 'ar' | 'hy' | 'az' | 'eu' | 'bn' | 'bg' | 'ca' | 'zh-CN' | 'zh-TW' | 'hr' | 'cs' | 'da' | 'nl' | 'en-GB' | 'en' | 'et' | 'fi' | 'fr' | 'fr-CA' | 'gl' | 'ka' | 'de' | 'el' | 'gu' | 'iw' | 'hi' | 'hu' | 'is' | 'id' | 'ga' | 'it' | 'ja' | 'kn' | 'km' | 'ko' | 'lo' | 'lv' | 'lt' | 'ms' | 'ml' | 'mr' | 'mn' | 'ne' | 'no' | 'fa' | 'fil' | 'pl' | 'pt' | 'pt-BR' | 'pt-PT' | 'ro' | 'ru' | 'sr' | 'si' | 'sk' | 'sl' | 'es' | 'es-MX' | 'sw' | 'sv' | 'ta' | 'te' | 'tr' | 'uk' | 'ur' | 'vi' | 'cy' | 'zu', required — Language code, can be two-letter for the standard variant or with additional two letters after a hyphen to identify a specific locale Value "pt-PT" is deprecated and will not work, use "pt" instead.
  - `location` LocationInput
    - `countryCode` string, required
    - `regionCode` string
    - `region` string
    - `address` string
    - `postalCode` string
    - `city` string, required
    - `longitude` union
      - number
      - string
    - `latitude` union
      - number
      - string
    - `remote` boolean
    - `hybrid` boolean
    - `hybridDescription` string
  - `compensation` Compensation
    - `min` number, double, nullable
    - `max` number, double, nullable
    - `currency` string, nullable
    - `period` 'HOURLY' | 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY', nullable
  - `jobAd` JobAdSections
    - `sections` object
      - `companyDescription` JobAdSection
        - `title` string
        - `text` string
      - `jobDescription` JobAdSection
        - `title` string
        - `text` string
      - `qualifications` JobAdSection
        - `title` string
        - `text` string
      - `additionalInformation` JobAdSection
        - `title` string
        - `text` string
      - `videos` JobAdVideosSection
        - `title` string
        - `urls` string[]

## Response `200`

Created job ad.

- JobAdItem
  - `id` string, required
  - `title` string, required
  - `language` Language, required
    - `code` string
    - `label` string
    - `labelNative` string
  - `location` Location — regionCode is not recommended to be used for countries other than the United States.
    - `country` string
    - `countryCode` string, required
    - `regionCode` string
    - `region` string
    - `city` string, required
    - `address` string, address
    - `postalCode` string
    - `longitude` string
    - `latitude` string
  - `compensation` Compensation
    - `min` number, double, nullable
    - `max` number, double, nullable
    - `currency` string, nullable
    - `period` 'HOURLY' | 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY', nullable
  - `jobAd` JobAdSections, required
    - `sections` object
      - `companyDescription` JobAdSection
        - `title` string
        - `text` string
      - `jobDescription` JobAdSection
        - `title` string
        - `text` string
      - `qualifications` JobAdSection
        - `title` string
        - `text` string
      - `additionalInformation` JobAdSection
        - `title` string
        - `text` string
      - `videos` JobAdVideosSection
        - `title` string
        - `urls` string[]
  - `createdOn` string, date-time, required
  - `updatedOn` string, date-time, required
  - `applyUrl` string, url
  - `postingStatus` 'PUBLISHED' | 'NOT_PUBLISHED', required
  - `default` boolean, required
  - `actions` object, required
    - `postings` Action, required
      - `url` string, required
      - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'OPTIONS' | 'DELETE' | 'HEAD' | 'CONNECT', required
  - `creator` Identifiable, required
    - `id` string, required
  - `visibility` 'PUBLIC' | 'INTERNAL' | 'PRIVATE', required

## Other responses

- `400` — with codes * **JOB_AD_LIMIT_REACHED** when job add limit (100 per job) is reached * **PROPERTY_INVALID** when one of job ad attribute contains invalid characters
- `404` — Job not found
- `422` — Input validation fails with codes * **COMPENSATION_INVALID_CURRENCY** – the currency code provided is invalid or not supported. * **TAGLINES_EXCEEDS_SECTION_SIZE** – Combined Additional Information and Job Ad Footers exceed the maximum allowed length.

---

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