Create job post

Create a new job post by duplicating an existing one. The new post is attached to the same parent job as the template (template_job_post_id) and published to the supplied job_board_id. Use this to spin up additional language, geography, or board variants of a job's listing without re-entering the content, application questions, or settings. To create the first post on a job, post a template from another job and adjust the resulting post; this endpoint does not create a post from scratch.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
integer
required

Id of an existing job post to duplicate. The new post is created on the same parent job as the template and copies its content, questions, and configuration. The template post itself is unchanged.

string
length between 1 and 255

Public-facing title for the new post. Defaults to the template post's title when omitted.

string | null

HTML body of the post shown to candidates. Sanitized server-side — only a limited element/attribute allowlist (including iframe, video, source) survives. Pass null or omit to inherit the template's content.

boolean | null

If true, create the post on the organization's internal job board (employees only). If false or null, the post is external. Must be consistent with job_board_id — internal job boards only accept internal posts.

string
enum

Initial publication status. Use live to publish immediately or draft to save as an unpublished working copy. Defaults to draft.

Allowed:
integer | null

Id of the demographic question set to attach to the new post for DE&I reporting. Pass null to opt out of demographic questions.

integer
required

Id of the job_board to publish the post to. A single post belongs to one board at a time; resolve available boards via GET /v3/job_boards.

Responses

401

Unauthorized

403

Forbidden

422

Unprocessable Content

Language
Credentials
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json