Create Job

post

https://api.getkini.com/jobs

Create a Job posting at a Company using the Company's ID.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

external_id

string

Job's ID in external ATS systems, used for integrations

title

string

required

length ≤ 255

Title of the job

description

string

Detailed description of the job's responsibilities and requirements

posting_url

uri

URL of the job posted on the company's career page

application_url

uri

URL through which applicants can apply on the company's career page

application_email

string

Email address through which applicants can apply

status

string

enum

Posting status of the job (active, deleted, archived)

Allowed:

remote

string

enum

Work mode of the job (remote, hybrid, on-site)

Allowed:

language

string

length between 2 and 2

Language of the job posting as an ISO 639-1 code (e.g. 'en', 'de')

category

string

enum

Category of the job, e.g. 'sales'

employment_type

string

enum

Employment type of the job (permanent, contract, minijob, etc.)

work_schedule

string

enum

Work schedule type for the position (full-time, part-time, flexible)

Allowed:

senority

string

enum

Required or expected seniority level

education

string

Required or preferred education level

start_date

string

Required or expected start date

contract_limitation

string

Contractual limitations or terms associated with the job

location_name

string

Full-text location of where the job is based

street

string

Street of the job's location

city

string

City of the job's location

country

string

Country of the job's location

postcode

string

Postal code of the job's location

longitude

string

Longitude coordinate of the job's location

latitude

string

Latitude coordinate of the job's location

salary

string

General description of the salary package

salary_from

integer

Starting salary range

salary_to

integer

Maximum salary range

salary_currency

string

Currency of the stated salary

salary_frequency

string

Payout frequency of the stated salary (annual, monthly, etc.)

contact_name

string

Name of the contact person responsible for the job posting

contact_email

string

E-Mail Address of the contact person responsible for the job posting

contact_title

string

Work title of the contact person responsible for the job posting

contact_phone

string

Phone Number of the contact person responsible for the job posting

banner_image

string

Banner Image URL

screening_questions

array of objects

screening_questions

description_sections

array of objects

description_sections

custom_fields

object

Custom fields for the job posting as key-value pairs

Headers

Company-Id

string

required

ID of the Company

content-type

string

enum

Defaults to application/json

Generated from available request content types

Allowed:

Response

201