API Reference

Create job

post
https://api.join.com/v2/jobs

Creates a job Note: When a job is created, it will be automatically set as active (meaning that the job will be multiposted on job boards).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string

id used to identify the job outside Join

string
required

title of the job

string
required

description of the job (in html)

salary
object

salary range information

integer
required

category id of the job (can only be one of sub categories)

string
required

language code according to iso 639-1

integer
required

id of the office you want to assign to this job. Please check offices endpoints for more details

integer
required

employment type of the job

contact
object

contact person displayed on the job ad

integer

seniority id of the job

string

contact person displayed on the job ad

string
enum

remote type of the job

Allowed:
string
enum

type of remote option (only if workplaceType REMOTE): remote from anywhere or remote within country of office

Allowed:
string
enum

candidate cv

Allowed:
string
enum

candidate cover letter

Allowed:
questions
array of objects

Screening questions

questions
hiringTeam
array of objects

Hiring team

hiringTeam
string
enum

status of the job

Allowed:
Responses

Updated about 1 month ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 1 month ago