Post a job with the API

Authentication

All requests must include your API key in the headers:
http X-API-Key: your_api_key

Request Body

Required Fields

Field	Type	Description
`title`	string	The job posting title (max 255 characters)
`description`	string	Full job description
`company_name`	string	Name of the hiring company

Optional Fields

Field	Type	Description	Default
`how_to_apply`	string	Instructions for applying	`null`
`is_remote`	boolean	Whether the job is remote	`false`
`is_highlighted`	boolean	Feature the job listing	`false`
`is_sticky`	boolean	Pin the job to the top	`false`
`location`	string	Job location	`null`
`location_restricted`	boolean	Location requirements	`false`
`category_id`	UUID	Job category identifier	`null`
`job_type`	string	Type of employment	`null`
`company_website`	string	Company’s website URL	`null`
`company_logo_url`	string	URL to company logo	`null`
`salary_min`	number	Minimum salary	`null`
`salary_max`	number	Maximum salary	`null`
`salary_currency`	string	Three-letter currency code	`null`
`salary_period`	string	Pay period	`null`
`contact_email`	string	Recruiter’s email	`null`
`expires_at`	string	Expiration date (ISO 8601)	`null`
`status`	string	Job status	`pending`

Enums

Job Type

full-time
part-time
contract
internship
temporary

Salary Period

hourly
daily
weekly
monthly
yearly

Status

pending
active
expired
draft

Example Request

bash curl -X POST https://api.kardow.com/jobs
-H “Content-Type: application/json”
-H “X-API-Key: your_api_key”
-d ’

“title”: “Senior Software Engineer”, “description”: “We are looking for an experienced software engineer…”, “company_name”: “Tech Corp”, “job_type”: “full-time”, “location”: “New York, NY”, “is_remote”: true, “salary_min”: 120000, “salary_max”: 180000, “salary_currency”: “USD”, “salary_period”: “yearly”, “contact_email”: “jobstechcorp.com” }’