Create Job

curl --request POST \
  --url https://api.kardow.com/jobs \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "title": "Backend Engineer",
  "description": "Build internal and public APIs.",
  "company_name": "Acme"
}
'

{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "title": "<string>",
    "slug": "<string>",
    "url": "<string>",
    "status": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "company_logo_url": "<string>"
  },
  "meta": {
    "organization_id": 123,
    "board_url": "<string>",
    "url": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<unknown>",
    "url": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<unknown>",
    "url": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<unknown>",
    "url": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<unknown>",
    "url": "<string>"
  }
}

POST

jobs

curl --request POST \
  --url https://api.kardow.com/jobs \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "title": "Backend Engineer",
  "description": "Build internal and public APIs.",
  "company_name": "Acme"
}
'

{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "title": "<string>",
    "slug": "<string>",
    "url": "<string>",
    "status": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "company_logo_url": "<string>"
  },
  "meta": {
    "organization_id": 123,
    "board_url": "<string>",
    "url": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<unknown>",
    "url": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<unknown>",
    "url": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<unknown>",
    "url": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<unknown>",
    "url": "<string>"
  }
}

Use this endpoint when an external system needs to publish jobs directly into Kardow.

Required Fields

title

string

required

Job title.

description

string

required

Full job description. HTML is accepted.

company_name

string

required

Hiring company name.

Application method

how_to_apply

string

Where candidates apply — an external URL, an email address, or a phone number. Pair with how_to_apply_method.

how_to_apply_method

string

Controls how Kardow presents the apply button. One of:

Value	When to use
`form-external`	`how_to_apply` is a link to an external application form or ATS (most common)
`website`	`how_to_apply` is a general company or job page
`email`	`how_to_apply` is an email address
`phone`	`how_to_apply` is a phone number
`form`	Kardow hosts the application form — no URL needed

If omitted, Kardow auto-detects from the how_to_apply value.

Common optional fields

Examples

Link to an external application form

The most common case: your ATS or careers page hosts the form.

cURL

curl --request POST \
  --url https://api.kardow.com/jobs \
  --header "Content-Type: application/json" \
  --header "x-api-key: your-api-key-here" \
  --data '{
    "title": "Backend Engineer",
    "description": "Build internal and public APIs.",
    "company_name": "Acme",
    "how_to_apply": "https://jobs.acme.com/backend-engineer",
    "how_to_apply_method": "form-external"
  }'

Apply via email

cURL

curl --request POST \
  --url https://api.kardow.com/jobs \
  --header "Content-Type: application/json" \
  --header "x-api-key: your-api-key-here" \
  --data '{
    "title": "Office Manager",
    "description": "Run day-to-day office operations.",
    "company_name": "Acme",
    "how_to_apply": "jobs@acme.com",
    "how_to_apply_method": "email"
  }'

Remote role with salary details

cURL

curl --request POST \
  --url https://api.kardow.com/jobs \
  --header "Content-Type: application/json" \
  --header "x-api-key: your-api-key-here" \
  --data '{
    "title": "Senior Product Designer",
    "description": "Lead product design across web and mobile.",
    "company_name": "Acme",
    "location": "Remote",
    "is_remote": true,
    "job_type": "full-time",
    "how_to_apply": "https://jobs.acme.com/designer",
    "how_to_apply_method": "form-external",
    "salary_min": 90000,
    "salary_max": 120000,
    "salary_currency": "USD",
    "salary_period": "yearly",
    "contact_email": "jobs@acme.com"
  }'

JavaScript example

const response = await fetch("https://api.kardow.com/jobs", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": process.env.KARDOW_API_KEY,
  },
  body: JSON.stringify({
    title: "Senior Software Engineer",
    description: "Build product features across the stack.",
    company_name: "Acme",
    location: "Remote",
    is_remote: true,
    job_type: "full-time",
    how_to_apply: "https://jobs.acme.com/senior-swe",
    how_to_apply_method: "form-external",
    contact_email: "jobs@acme.com",
  }),
});

const result = await response.json();
console.log(result.data.id);

Response Shape

data.id

string

required

Newly created job UUID.

data.slug

string

required

Job URL path (without the domain).

data.url

string

required

The full, shareable public URL to the created job on your live board (uses your active custom domain when you have one).

data.status

string

required

Current job status.

meta.organization_id

number

required

Organization that owns the job.

meta.board_url

string

required

The base public URL of your job board.

meta.url

string

required

The full public URL for the created job (same as data.url).

Example response

{
  "data": {
    "id": "4d1b6fe8-688f-467c-b233-b5d6a51ce1cb",
    "title": "Backend Engineer",
    "slug": "/companies/acme/jobs/backend-engineer-4d1b6fe8688f467cb233b5d6a51ce1cb",
    "url": "https://jobs.acme.com/companies/acme/jobs/backend-engineer-4d1b6fe8688f467cb233b5d6a51ce1cb",
    "status": "pending",
    "created_at": "2026-03-10T12:00:00.000Z",
    "company_logo_url": null
  },
  "meta": {
    "organization_id": 42,
    "board_url": "https://jobs.acme.com",
    "url": "https://jobs.acme.com/companies/acme/jobs/backend-engineer-4d1b6fe8688f467cb233b5d6a51ce1cb"
  }
}

Authorizations

x-api-key

string

header

required

API key for authentication. Get yours from Settings > API Keys in the Kardow dashboard.

Body

application/json

title

string

required

description

string

required

company_name

string

required

apply_url

string

Preferred field for the application destination — an external URL, email address, or phone number. Alias of how_to_apply (which is still accepted).

apply_type

enum<string>

Preferred field for how candidates apply. Alias of how_to_apply_method.

Available options:

form-external,

website,

email,

phone,

form

how_to_apply

string

Legacy alias of apply_url. Where candidates apply — an external URL, email, or phone number.

how_to_apply_method

enum<string>

Legacy alias of apply_type. form-external = external ATS/form (most common), website = general job page, email = email address, phone = phone number, form = Kardow hosts the form.

Available options:

form-external,

website,

email,

phone,

form

posted_by_email

string<email>

Email of the employer account posting this job. Must match a job board user in the org, else the request returns 422 employer_not_found.

Response

Job created

data

object

Show child attributes

Getting Started

Analytics

Jobs

Applications

Content

Members

Users

Webhooks

CMS

Required Fields

Application method

Common optional fields

Examples

Link to an external application form

Apply via email

Remote role with salary details

JavaScript example

Response Shape

Example response

Authorizations

Body

Response

​Required Fields

​Application method

​Common optional fields

​Examples

​Link to an external application form

​Apply via email

​Remote role with salary details

​JavaScript example

​Response Shape

​Example response

Authorizations

Body

Response

Required Fields

Application method

Common optional fields

Examples

Link to an external application form

Apply via email

Remote role with salary details

JavaScript example

Response Shape

Example response