Skip to main content
POST
/
v2
/
recruiter
Publish Job Posting
curl --request POST \
  --url https://api.linkupapi.com/v2/recruiter \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "account_id": "<string>",
  "action": "<string>",
  "params": {
    "job_id": "<string>"
  }
}
'
{
  "success": true,
  "data": {},
  "metadata": {
    "action": "publish_job",
    "account_id": "your-account-id",
    "credits_consumed": 1,
    "timestamp": "2026-03-24T12:00:00Z"
  }
}

​
Overview

Publish a draft job posting, making it visible to candidates and open for applications.
This endpoint consumes 1 credit per request.

​
Request

​
x-api-key
string
required
Your API key for authentication.
​
account_id
string
required
The unique identifier of the account to use.
​
action
string
required
Must be "publish_job".
​
params
object
required

​
Response

​
success
boolean
Indicates whether the request was successful.
​
data
object
Confirmation of the publish action.
​
metadata
object
{
  "success": true,
  "data": {},
  "metadata": {
    "action": "publish_job",
    "account_id": "your-account-id",
    "credits_consumed": 1,
    "timestamp": "2026-03-24T12:00:00Z"
  }
}