Skip to main content
POST

Authentication

string
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Request Body

string
required
Unique identifier for the company
string
required
Title of the job position
string
required
Department where the job belongs. Allowed departments: Accounting/Auditing Administrative Advertising Analyst Art/Creative Business Development Consulting Customer Service Design Distribution Education Engineering Finance Health Care Provider Human Resources Information Technology Legal Management Manufacturing Marketing Product Management Project Management Production Public Relations Purchasing Quality Assurance Research Sales Science Strategy/Planning Supply Chain Training Operations Other
string
required
Country where the job is located
string
City where the job is located
number
required
Salary information for the position
string
required
Currency of the salary. Valid currency is in three-letter alphabetic codes. Examples: USD EUR GBP
string
required
Period of the salary. Options: Per hour Per day Per week Bi-weekly Per month Per year
boolean
Hide salary in job application. Default is false
string
required
Employment type. Options: Full-time Part-time Contract Freelance Internship Temporary Project-based
string
required
Workplace type. Options: On-site Remote Hybrid
string
required
Career Level. Options: Junior Mid-level Senior Team Leader Manager Director VP C-level
string
required
Full description of the job requirements and responsibilities
string[]
required
Array of job posting sources. Example: LinkedIn Referral or any source you would like to add.
string
Industry classification (optional).
string
URL slug for the public job board page. If omitted, auto-generated from the job title with a random 4-char suffix.
object
Application form configuration (optional). Object shape:
custom[].type must be one of: text textarea number date url file single_select multi_select video audio.
string
Job posting status. Accepted input values: Pending Active Paused Hired Closed. Values are normalized to lowercase before storage. Pending is mapped to draft. Hired is accepted as a deprecated alias for Closed. Default is draft.

Response

boolean
Indicates if the job was created successfully
string
Unique identifier for the newly created job
string
Current status of the job posting (lowercase). One of: draft active paused closed
integer
Number of applications received for this job
array
Array of application objects

Error Responses

Authorization Errors

400 - Bad Request
400 - Bad Request

Request Format Errors

400 - Bad Request

Missing Required Fields

400 - Bad Request
400 - Bad Request
400 - Bad Request
400 - Bad Request
400 - Bad Request
400 - Bad Request
400 - Bad Request
400 - Bad Request
400 - Bad Request
400 - Bad Request
400 - Bad Request
400 - Bad Request

Field Validation Errors

400 - Bad Request
400 - Bad Request
400 - Bad Request
400 - Bad Request
400 - Bad Request
400 - Bad Request
400 - Bad Request
400 - Bad Request

Company Authorization Errors

401 - Unauthorized
401 - Unauthorized

Limit Reached Error

402 - Payment Required

Token Validation Errors

401 - Unauthorized
401 - Unauthorized