---
title: "Publishes a job ad"
method: POST
path: "/jobs/{jobId}/jobads/{jobAdId}/postings"
tags: ["jobs"]
---

# Publishes a job ad

`POST /jobs/{jobId}/jobads/{jobAdId}/postings`

Publishes a job ad to internal sources (Career Pages, Job Widget, Facebook App, WordPress Plugin, Posting API) and optionally to all free job aggregators.

By default it's set to publish to job aggregators and internal sources

It reflects a Publish action available in the SmartRecruiters UI.

Note: Internal sources depend on a company's payment plan.

## Request body

- Publication
  - `aggregators` boolean
  - `visibility` 'PUBLIC' | 'INTERNAL'
  - `includeInternal` boolean
  - `delayPublicInDays` integer

## Response `202`

Posting scheduled

- JobAdPublicationScheduled
  - `postingStatus` 'PENDING'

## Other responses

- `400` — with code * **PUBLISHED_JOB_AD_LIMIT_REACHED** when company's limit for published job ads has been reached
- `401` — with code * **ACCESS_FORBIDDEN** when user is not authorize to publish a job
- `403` — with code * **JOB_NOT_POSTED** when default job ad for the job has not been published
- `404` — with code * **JOBAD_NOT_FOUND** when job ad has not been found
- `422` — with codes * **COMPENSATION_REQUIRED** – compensation is required by company configuration but is missing or incomplete. * **COMPENSATION_HIDDEN** – compensation should not be provided when company configuration requires it to be hidden. * **COMPENSATION_INVALID_CURRENCY** – the currency code provided is invalid or not supported.

---

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