# publish_job_posting: Publish a job posting

Publish a job posting draft, free or promoted. This action can change or spend something, and it happens right away. Plan: Free and Connect.

```
POST https://api.heyreagent.com/v1/actions/publish_job_posting
Authorization: Bearer YOUR_KEY
content-type: application/json

{
  "draftId": "PASTE_JOB_ID_HERE",
  "mode": "FREE"
}
```

## What you give it

- `draftId` (needed): a job id. The draft id (from create_job_posting, or list_job_postings category draft). Where to get it: Run `list_job_postings` and use `jobPostings[].id`.
- `mode` (needed): one of: FREE, PROMOTED, PROMOTED_PLUS. FREE costs nothing. PROMOTED and PROMOTED_PLUS (ordinary postings only) are paid.
- `budget` (optional): a group of fields. Paid modes only: the most to spend per day or per month.
  - `period` (needed): one of: daily, monthly. 
  - `currency` (needed): text, up to 3 characters. 
  - `amount` (needed): a number. 
- `service` (optional): one of: CLASSIC, RECRUITER. Which LinkedIn product the job posting belongs to (default CLASSIC).
- `hiringPhotoFrame` (optional): true or false. Add the #Hiring frame to your profile picture.
- `bypassEmailVerification` (optional): true or false. Skip LinkedIn's check that you may post for this company.
- `connectionId` (optional): a connection id. Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one. Where to get it: Run `list_linkedin_accounts` and use `accounts[].id`.

## What you get back

- `draftId`
- `mode`
- `paid`
- `from`: the account it ran on
- `usedToday`: number
- `dailyLimit`: number
- `jobState`: active | draft | review | closed | paused
- `jobId`: a job id
- `type`: EMAIL_VERIFICATION | OTP

## Good to know

- draftId is the job id of a draft: from create_job_posting, or list_job_postings with category "draft".
- Two answers are possible. Published: jobState and jobId. Not yet: type EMAIL_VERIFICATION or OTP, and LinkedIn has sent a code — pass it to solve_job_posting_checkpoint.

Page: https://heyreagent.com/docs/actions/publish_job_posting