---
updatedAt: 2026-06-01T12:15:48.000Z
agentTools:
  projectIndex: https://developers.smartrecruiters.com/llms.txt
---

# Publishes a job ad

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.


# OpenAPI definition

```json
{
  "openapi": "3.0.2",
  "info": {
    "version": "1.1.0",
    "title": "Jobs API",
    "contact": {
      "name": "SmartRecruiters",
      "url": "https://developers.smartrecruiters.com"
    }
  },
  "tags": [
    {
      "name": "jobs"
    }
  ],
  "paths": {
    "/jobs/{jobId}/jobads/{jobAdId}/postings": {
      "parameters": [
        {
          "$ref": "#/components/parameters/jobId"
        },
        {
          "$ref": "#/components/parameters/jobAdId"
        }
      ],
      "post": {
        "responses": {
          "202": {
            "description": "Posting scheduled",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JobAdPublicationScheduled"
                }
              }
            }
          },
          "400": {
            "description": "with code\n* **PUBLISHED_JOB_AD_LIMIT_REACHED** when company's limit for published job ads has been reached\n",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "with code\n* **ACCESS_FORBIDDEN** when user is not authorize to publish a job\n",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "with code\n* **JOB_NOT_POSTED** when default job ad for the job has not been published\n",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "with code\n* **JOBAD_NOT_FOUND** when job ad has not been found\n",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "422": {
            "description": "with codes\n* **COMPENSATION_REQUIRED** – compensation is required by company configuration but is missing or incomplete.\n* **COMPENSATION_HIDDEN** – compensation should not be provided when company configuration requires it to be hidden.\n* **COMPENSATION_INVALID_CURRENCY** – the currency code provided is invalid or not supported.\n",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "description": "Publishes a job ad to internal sources (Career Pages, Job Widget, Facebook App, WordPress Plugin, Posting API) and optionally to all free job aggregators.\n\nBy default it's set to publish to job aggregators and internal sources\n\nIt reflects a Publish action available in the SmartRecruiters UI.\n\nNote: Internal sources depend on a company's payment plan.\n",
        "tags": [
          "jobs"
        ],
        "summary": "Publishes a job ad",
        "operationId": "jobs.jobads.postings.create",
        "security": [
          {
            "key": []
          },
          {
            "oauth": [
              "jobs_manage"
            ]
          }
        ],
        "requestBody": {
          "$ref": "#/components/requestBodies/Publication"
        }
      }
    }
  },
  "components": {
    "requestBodies": {
      "Publication": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Publication"
            }
          }
        },
        "description": "Publication object"
      }
    },
    "securitySchemes": {
      "key": {
        "type": "apiKey",
        "in": "header",
        "name": "x-smarttoken"
      },
      "oauth": {
        "type": "oauth2",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "https://www.smartrecruiters.com/identity/oauth/allow",
            "tokenUrl": "https://api.smartrecruiters.com/identity/oauth/token",
            "scopes": {
              "jobs_read": "Access Jobs",
              "jobs_manage": "Manage jobs",
              "jobs_publications_manage": "Publish Jobs"
            }
          }
        }
      }
    },
    "schemas": {
      "ErrorResponse": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string"
          },
          "errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "Error": {
        "type": "object",
        "required": [
          "code"
        ],
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      },
      "Publication": {
        "type": "object",
        "properties": {
          "aggregators": {
            "type": "boolean",
            "default": true
          },
          "visibility": {
            "type": "string",
            "default": "PUBLIC",
            "enum": [
              "PUBLIC",
              "INTERNAL"
            ]
          },
          "includeInternal": {
            "type": "boolean",
            "default": true
          },
          "delayPublicInDays": {
            "type": "integer",
            "default": 0
          }
        }
      },
      "JobAdPublicationScheduled": {
        "type": "object",
        "properties": {
          "postingStatus": {
            "type": "string",
            "enum": [
              "PENDING"
            ]
          }
        }
      }
    },
    "parameters": {
      "jobId": {
        "in": "path",
        "description": "job identifier",
        "name": "jobId",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "jobAdId": {
        "in": "path",
        "description": "job ad identifier",
        "name": "jobAdId",
        "required": true,
        "schema": {
          "type": "string"
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.smartrecruiters.com"
    }
  ]
}
```