Post a job with the API

Create a new job posting using your API key.

Written By Simon

Last updated Almost 2 years ago

POST https://api.kardow.com/jobs

Authentication

All requests must include your API key in the headers:

X-API-Key: your_api_key

Request Body

Required Fields

		FieldTypeDescription
`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": "jobs@techcorp.com"
}'

Successful Response

{
"data": {
"id": "uuid-here",
"title": "Senior Software Engineer",
"slug": "senior-software-engineer-techcorp-newyork-1234567890",
"status": "pending",
"created_at": "2024-01-01T00:00:00Z"
},
"meta": {
"organization_id": "123"
}
}

Notes

Salary information is optional but if provided, both salary_currency and salary_period are required
The job slug is automatically generated from the title, company name, and location
Dates should be provided in ISO 8601 format (e.g., "2024-12-31T23:59:59Z")

Rate Limits

100 requests per minute per API key
Contact support for higher limits

Support

Need help? Contact us:

Documentation: https://kardow.featurebase.app
Email: simon@kardow.com
Feature requests: https://kardow.userjot.com

Was this helpful?

Still need help? Share an idea