Post a job with the API

Create a new job posting using your API key.

Written By Simon

Last updated 3 months 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

Example
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

Example
{
"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