Jobs
Create Job
Create a new job posting from your ATS, CRM, or internal workflow
POST
Use this endpoint when an external system needs to publish jobs directly into Kardow.
Required Fields
Application method
Where candidates apply: an external URL, an email address, or a phone number. Required unless
how_to_apply_method is form.This is not the job’s own page on your board. That URL is generated automatically and returned in the response.Controls how Kardow presents the apply button. One of:
If omitted, Kardow detects the method from the
how_to_apply value, which is usually the safest choice.A method that contradicts its value is also rejected: email pointing at a URL would render a broken mailto: link. Where the intent is unambiguous, Kardow recovers instead of failing: email with no destination falls back to contact_email, website falls back to company_website, and a bare domain is upgraded to https://.The response echoes the resolved destination in meta.apply so you can confirm what was stored.Common optional fields
Category name, e.g.
Engineering. Matched to an existing category (case-insensitive) or created if new. See Categories.Every category the job is listed under, as names or ids, e.g.
["Backend", "DevOps"]. The job appears under each of them on the board. The first is the main category unless category or category_id is sent. See Categories.The location shown on the job:
Remote, Paris, San Francisco, CA, or a full street address.Kardow resolves this to a real place and links the job to it, so the job appears on the right location page and in location filters. Street addresses are filed under their city, and the exact coordinates are kept on the job for map pins.An existing location id from Locations. Takes precedence over
location text and skips resolution entirely.Resolve first and pass the id whenever you can: it removes any guesswork about which place the job lands on.Two-letter country code used when resolving
location text, e.g. ca. Ignored when location_id is given.Examples
Link to an external application form
The most common case: your ATS or careers page hosts the form.cURL
Apply via email
cURL
Remote role with salary details
cURL
JavaScript example
Response Shape
The full, shareable public URL to the created job on your live board (uses your active custom domain when you have one).
Human-readable summary of the apply destination that was actually stored, e.g.
email: jobs@acme.com. Check it: if it says Kardow-hosted application form when you meant an external one, the destination did not arrive.Example response
Authorizations
Body
application/json