POST
/
jobs.json
Create job
curl --request POST \
  --url https://elixir.jobkit.io/jobs.json \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "title": "<string>",
  "description": "<string>",
  "location": "<string>",
  "salary": 123,
  "salary_currency": "<string>",
  "salary_period": "<string>",
  "arrangement": "<string>",
  "category_id": 123,
  "term_id": 123,
  "company": "<string>",
  "company_website": "<string>",
  "application_type": "<string>",
  "application_url": "<string>",
  "application_email": "<string>",
  "plan_id": 123
}'
{
  "id": 2,
  "title": "Job title",
  "description": "Job description in Markdown format",
  "location": "Worldwide",
  "arrangement": "remote",
  "salary": "120000",
  "salary_currency": "USD",
  "salary_period": "yearly",
  "company": "Company LLC",
  "company_website": "https://www.company.com",
  "application_type": "url",
  "application_url": "https://www.company.com/application",
  "term": {
    "id": 1,
    "name": "Full-time"
  },
  "category": {
    "id": 1,
    "name": "Engineering"
  },
  "plan": {
    "id": 1,
    "name": "Basic",
    "price": 0,
    "period": 30,
    "highlight": false,
    "badge": false,
    "pin": false
  },
  "logo": "https://job.board.com/files/.../2.png",
  "url": "https://job.board.com/jobs/2.json",
  "preview_image_url": "https://job.board.com/jobs/2.png",
  "created_at": "2025-01-10T18:21:59+00:00"
}
Requires user authentication
​
title
string
required
The job title, maximum 64 characters
​
description
string
required
The job description in Markdown format
​
location
string
required
The job location, e.g. Worldwide
​
salary
integer
The job salary, can be empty if not specified
​
salary_currency
string
default:"USD"
The job salary currency in ISO format, required when salary is specified
​
salary_period
string
default:"monthly"
The job salary period, should be either hourly, daily, weekly, monthly or yearly
​
arrangement
string
default:"remote"
required
The job arrangement, should be either remote, onsite or hybrid
​
category_id
integer
required
The id of the job category
​
term_id
integer
required
The id of the job term
​
company
string
required
The name of the hiring company
​
company_website
string
required
The URL of the hiring company website
​
application_type
string
default:"url"
required
The job application type, should be either url or email
​
application_url
string
The job application URL, required if application_type is url
​
application_email
string
The job application email, required if application_type is email
The job logo image file, maximum 5MB
​
plan_id
integer
required
The id of the job payment plan
{
  "id": 2,
  "title": "Job title",
  "description": "Job description in Markdown format",
  "location": "Worldwide",
  "arrangement": "remote",
  "salary": "120000",
  "salary_currency": "USD",
  "salary_period": "yearly",
  "company": "Company LLC",
  "company_website": "https://www.company.com",
  "application_type": "url",
  "application_url": "https://www.company.com/application",
  "term": {
    "id": 1,
    "name": "Full-time"
  },
  "category": {
    "id": 1,
    "name": "Engineering"
  },
  "plan": {
    "id": 1,
    "name": "Basic",
    "price": 0,
    "period": 30,
    "highlight": false,
    "badge": false,
    "pin": false
  },
  "logo": "https://job.board.com/files/.../2.png",
  "url": "https://job.board.com/jobs/2.json",
  "preview_image_url": "https://job.board.com/jobs/2.png",
  "created_at": "2025-01-10T18:21:59+00:00"
}