Create job
curl --request POST \
--url https://api.instaview.sk/jobs \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "Senior TypeScript Developer",
"description": "We are looking for an experienced TypeScript developer...",
"jobUrl": "https://company.com/careers/senior-typescript-dev",
"benefits": "Health insurance, remote work, flexible hours",
"requiredSkills": [
"TypeScript",
"React",
"Node.js"
],
"niceToHaveSkills": [
"Docker",
"AWS",
"GraphQL"
],
"languageRequirements": [
{
"language": "EN",
"proficiency": "B2"
},
{
"language": "SK",
"proficiency": "C1"
}
],
"education": [
"BACHELOR_LEVEL",
"MASTER_LEVEL"
],
"experience": "FIVE_TO_10_YEARS",
"contractType": "FULL_TIME",
"status": "OPEN",
"location": {
"workMode": "REMOTE",
"street": "Hlavná 123",
"city": "Bratislava",
"postalCode": "81101",
"countryCode": "SK"
},
"salary": {
"min": 50000,
"max": 80000,
"currency": "USD",
"period": "YEARLY"
},
"metadata": {
"externalJobId": "JOB-12345",
"department": "Engineering",
"hiringManager": "Jane Doe"
}
}
'import requests
url = "https://api.instaview.sk/jobs"
payload = {
"title": "Senior TypeScript Developer",
"description": "We are looking for an experienced TypeScript developer...",
"jobUrl": "https://company.com/careers/senior-typescript-dev",
"benefits": "Health insurance, remote work, flexible hours",
"requiredSkills": ["TypeScript", "React", "Node.js"],
"niceToHaveSkills": ["Docker", "AWS", "GraphQL"],
"languageRequirements": [
{
"language": "EN",
"proficiency": "B2"
},
{
"language": "SK",
"proficiency": "C1"
}
],
"education": ["BACHELOR_LEVEL", "MASTER_LEVEL"],
"experience": "FIVE_TO_10_YEARS",
"contractType": "FULL_TIME",
"status": "OPEN",
"location": {
"workMode": "REMOTE",
"street": "Hlavná 123",
"city": "Bratislava",
"postalCode": "81101",
"countryCode": "SK"
},
"salary": {
"min": 50000,
"max": 80000,
"currency": "USD",
"period": "YEARLY"
},
"metadata": {
"externalJobId": "JOB-12345",
"department": "Engineering",
"hiringManager": "Jane Doe"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
title: 'Senior TypeScript Developer',
description: 'We are looking for an experienced TypeScript developer...',
jobUrl: 'https://company.com/careers/senior-typescript-dev',
benefits: 'Health insurance, remote work, flexible hours',
requiredSkills: ['TypeScript', 'React', 'Node.js'],
niceToHaveSkills: ['Docker', 'AWS', 'GraphQL'],
languageRequirements: [{language: 'EN', proficiency: 'B2'}, {language: 'SK', proficiency: 'C1'}],
education: ['BACHELOR_LEVEL', 'MASTER_LEVEL'],
experience: 'FIVE_TO_10_YEARS',
contractType: 'FULL_TIME',
status: 'OPEN',
location: {
workMode: 'REMOTE',
street: 'Hlavná 123',
city: 'Bratislava',
postalCode: '81101',
countryCode: 'SK'
},
salary: {min: 50000, max: 80000, currency: 'USD', period: 'YEARLY'},
metadata: {
externalJobId: 'JOB-12345',
department: 'Engineering',
hiringManager: 'Jane Doe'
}
})
};
fetch('https://api.instaview.sk/jobs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.instaview.sk/jobs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'title' => 'Senior TypeScript Developer',
'description' => 'We are looking for an experienced TypeScript developer...',
'jobUrl' => 'https://company.com/careers/senior-typescript-dev',
'benefits' => 'Health insurance, remote work, flexible hours',
'requiredSkills' => [
'TypeScript',
'React',
'Node.js'
],
'niceToHaveSkills' => [
'Docker',
'AWS',
'GraphQL'
],
'languageRequirements' => [
[
'language' => 'EN',
'proficiency' => 'B2'
],
[
'language' => 'SK',
'proficiency' => 'C1'
]
],
'education' => [
'BACHELOR_LEVEL',
'MASTER_LEVEL'
],
'experience' => 'FIVE_TO_10_YEARS',
'contractType' => 'FULL_TIME',
'status' => 'OPEN',
'location' => [
'workMode' => 'REMOTE',
'street' => 'Hlavná 123',
'city' => 'Bratislava',
'postalCode' => '81101',
'countryCode' => 'SK'
],
'salary' => [
'min' => 50000,
'max' => 80000,
'currency' => 'USD',
'period' => 'YEARLY'
],
'metadata' => [
'externalJobId' => 'JOB-12345',
'department' => 'Engineering',
'hiringManager' => 'Jane Doe'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.instaview.sk/jobs"
payload := strings.NewReader("{\n \"title\": \"Senior TypeScript Developer\",\n \"description\": \"We are looking for an experienced TypeScript developer...\",\n \"jobUrl\": \"https://company.com/careers/senior-typescript-dev\",\n \"benefits\": \"Health insurance, remote work, flexible hours\",\n \"requiredSkills\": [\n \"TypeScript\",\n \"React\",\n \"Node.js\"\n ],\n \"niceToHaveSkills\": [\n \"Docker\",\n \"AWS\",\n \"GraphQL\"\n ],\n \"languageRequirements\": [\n {\n \"language\": \"EN\",\n \"proficiency\": \"B2\"\n },\n {\n \"language\": \"SK\",\n \"proficiency\": \"C1\"\n }\n ],\n \"education\": [\n \"BACHELOR_LEVEL\",\n \"MASTER_LEVEL\"\n ],\n \"experience\": \"FIVE_TO_10_YEARS\",\n \"contractType\": \"FULL_TIME\",\n \"status\": \"OPEN\",\n \"location\": {\n \"workMode\": \"REMOTE\",\n \"street\": \"Hlavná 123\",\n \"city\": \"Bratislava\",\n \"postalCode\": \"81101\",\n \"countryCode\": \"SK\"\n },\n \"salary\": {\n \"min\": 50000,\n \"max\": 80000,\n \"currency\": \"USD\",\n \"period\": \"YEARLY\"\n },\n \"metadata\": {\n \"externalJobId\": \"JOB-12345\",\n \"department\": \"Engineering\",\n \"hiringManager\": \"Jane Doe\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.instaview.sk/jobs")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"Senior TypeScript Developer\",\n \"description\": \"We are looking for an experienced TypeScript developer...\",\n \"jobUrl\": \"https://company.com/careers/senior-typescript-dev\",\n \"benefits\": \"Health insurance, remote work, flexible hours\",\n \"requiredSkills\": [\n \"TypeScript\",\n \"React\",\n \"Node.js\"\n ],\n \"niceToHaveSkills\": [\n \"Docker\",\n \"AWS\",\n \"GraphQL\"\n ],\n \"languageRequirements\": [\n {\n \"language\": \"EN\",\n \"proficiency\": \"B2\"\n },\n {\n \"language\": \"SK\",\n \"proficiency\": \"C1\"\n }\n ],\n \"education\": [\n \"BACHELOR_LEVEL\",\n \"MASTER_LEVEL\"\n ],\n \"experience\": \"FIVE_TO_10_YEARS\",\n \"contractType\": \"FULL_TIME\",\n \"status\": \"OPEN\",\n \"location\": {\n \"workMode\": \"REMOTE\",\n \"street\": \"Hlavná 123\",\n \"city\": \"Bratislava\",\n \"postalCode\": \"81101\",\n \"countryCode\": \"SK\"\n },\n \"salary\": {\n \"min\": 50000,\n \"max\": 80000,\n \"currency\": \"USD\",\n \"period\": \"YEARLY\"\n },\n \"metadata\": {\n \"externalJobId\": \"JOB-12345\",\n \"department\": \"Engineering\",\n \"hiringManager\": \"Jane Doe\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.instaview.sk/jobs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"title\": \"Senior TypeScript Developer\",\n \"description\": \"We are looking for an experienced TypeScript developer...\",\n \"jobUrl\": \"https://company.com/careers/senior-typescript-dev\",\n \"benefits\": \"Health insurance, remote work, flexible hours\",\n \"requiredSkills\": [\n \"TypeScript\",\n \"React\",\n \"Node.js\"\n ],\n \"niceToHaveSkills\": [\n \"Docker\",\n \"AWS\",\n \"GraphQL\"\n ],\n \"languageRequirements\": [\n {\n \"language\": \"EN\",\n \"proficiency\": \"B2\"\n },\n {\n \"language\": \"SK\",\n \"proficiency\": \"C1\"\n }\n ],\n \"education\": [\n \"BACHELOR_LEVEL\",\n \"MASTER_LEVEL\"\n ],\n \"experience\": \"FIVE_TO_10_YEARS\",\n \"contractType\": \"FULL_TIME\",\n \"status\": \"OPEN\",\n \"location\": {\n \"workMode\": \"REMOTE\",\n \"street\": \"Hlavná 123\",\n \"city\": \"Bratislava\",\n \"postalCode\": \"81101\",\n \"countryCode\": \"SK\"\n },\n \"salary\": {\n \"min\": 50000,\n \"max\": 80000,\n \"currency\": \"USD\",\n \"period\": \"YEARLY\"\n },\n \"metadata\": {\n \"externalJobId\": \"JOB-12345\",\n \"department\": \"Engineering\",\n \"hiringManager\": \"Jane Doe\"\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "123e4567-e89b-12d3-a456-426614174000",
"companyId": "987e6543-e21b-12d3-a456-426614174000",
"title": "Senior TypeScript Developer",
"status": "OPEN",
"createdAt": "2024-11-16T10:30:00Z",
"updatedAt": "2024-11-16T10:30:00Z",
"description": "We are looking for an experienced TypeScript developer...",
"jobUrl": "https://company.com/careers/senior-typescript-dev",
"benefits": "Health insurance, remote work, flexible hours",
"requiredSkills": [
"TypeScript",
"React",
"Node.js"
],
"niceToHaveSkills": [
"Docker",
"AWS"
],
"languageRequirements": [
{
"language": "EN",
"proficiency": "B2"
},
{
"language": "SK",
"proficiency": "C1"
}
],
"education": [
"BACHELORS"
],
"experience": "SENIOR",
"contractType": "FULL_TIME",
"location": {
"workMode": "REMOTE",
"street": "Hlavná 123",
"city": "Bratislava",
"postalCode": "81101",
"countryCode": "SK"
},
"salary": {
"min": 50000,
"max": 80000,
"currency": "USD",
"period": "YEARLY"
},
"metadata": {
"externalJobId": "JOB-12345",
"department": "Engineering"
}
}Jobs
Create Job
Creates a new job scoped to the API key’s company.
POST
/
jobs
Create job
curl --request POST \
--url https://api.instaview.sk/jobs \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "Senior TypeScript Developer",
"description": "We are looking for an experienced TypeScript developer...",
"jobUrl": "https://company.com/careers/senior-typescript-dev",
"benefits": "Health insurance, remote work, flexible hours",
"requiredSkills": [
"TypeScript",
"React",
"Node.js"
],
"niceToHaveSkills": [
"Docker",
"AWS",
"GraphQL"
],
"languageRequirements": [
{
"language": "EN",
"proficiency": "B2"
},
{
"language": "SK",
"proficiency": "C1"
}
],
"education": [
"BACHELOR_LEVEL",
"MASTER_LEVEL"
],
"experience": "FIVE_TO_10_YEARS",
"contractType": "FULL_TIME",
"status": "OPEN",
"location": {
"workMode": "REMOTE",
"street": "Hlavná 123",
"city": "Bratislava",
"postalCode": "81101",
"countryCode": "SK"
},
"salary": {
"min": 50000,
"max": 80000,
"currency": "USD",
"period": "YEARLY"
},
"metadata": {
"externalJobId": "JOB-12345",
"department": "Engineering",
"hiringManager": "Jane Doe"
}
}
'import requests
url = "https://api.instaview.sk/jobs"
payload = {
"title": "Senior TypeScript Developer",
"description": "We are looking for an experienced TypeScript developer...",
"jobUrl": "https://company.com/careers/senior-typescript-dev",
"benefits": "Health insurance, remote work, flexible hours",
"requiredSkills": ["TypeScript", "React", "Node.js"],
"niceToHaveSkills": ["Docker", "AWS", "GraphQL"],
"languageRequirements": [
{
"language": "EN",
"proficiency": "B2"
},
{
"language": "SK",
"proficiency": "C1"
}
],
"education": ["BACHELOR_LEVEL", "MASTER_LEVEL"],
"experience": "FIVE_TO_10_YEARS",
"contractType": "FULL_TIME",
"status": "OPEN",
"location": {
"workMode": "REMOTE",
"street": "Hlavná 123",
"city": "Bratislava",
"postalCode": "81101",
"countryCode": "SK"
},
"salary": {
"min": 50000,
"max": 80000,
"currency": "USD",
"period": "YEARLY"
},
"metadata": {
"externalJobId": "JOB-12345",
"department": "Engineering",
"hiringManager": "Jane Doe"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
title: 'Senior TypeScript Developer',
description: 'We are looking for an experienced TypeScript developer...',
jobUrl: 'https://company.com/careers/senior-typescript-dev',
benefits: 'Health insurance, remote work, flexible hours',
requiredSkills: ['TypeScript', 'React', 'Node.js'],
niceToHaveSkills: ['Docker', 'AWS', 'GraphQL'],
languageRequirements: [{language: 'EN', proficiency: 'B2'}, {language: 'SK', proficiency: 'C1'}],
education: ['BACHELOR_LEVEL', 'MASTER_LEVEL'],
experience: 'FIVE_TO_10_YEARS',
contractType: 'FULL_TIME',
status: 'OPEN',
location: {
workMode: 'REMOTE',
street: 'Hlavná 123',
city: 'Bratislava',
postalCode: '81101',
countryCode: 'SK'
},
salary: {min: 50000, max: 80000, currency: 'USD', period: 'YEARLY'},
metadata: {
externalJobId: 'JOB-12345',
department: 'Engineering',
hiringManager: 'Jane Doe'
}
})
};
fetch('https://api.instaview.sk/jobs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.instaview.sk/jobs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'title' => 'Senior TypeScript Developer',
'description' => 'We are looking for an experienced TypeScript developer...',
'jobUrl' => 'https://company.com/careers/senior-typescript-dev',
'benefits' => 'Health insurance, remote work, flexible hours',
'requiredSkills' => [
'TypeScript',
'React',
'Node.js'
],
'niceToHaveSkills' => [
'Docker',
'AWS',
'GraphQL'
],
'languageRequirements' => [
[
'language' => 'EN',
'proficiency' => 'B2'
],
[
'language' => 'SK',
'proficiency' => 'C1'
]
],
'education' => [
'BACHELOR_LEVEL',
'MASTER_LEVEL'
],
'experience' => 'FIVE_TO_10_YEARS',
'contractType' => 'FULL_TIME',
'status' => 'OPEN',
'location' => [
'workMode' => 'REMOTE',
'street' => 'Hlavná 123',
'city' => 'Bratislava',
'postalCode' => '81101',
'countryCode' => 'SK'
],
'salary' => [
'min' => 50000,
'max' => 80000,
'currency' => 'USD',
'period' => 'YEARLY'
],
'metadata' => [
'externalJobId' => 'JOB-12345',
'department' => 'Engineering',
'hiringManager' => 'Jane Doe'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.instaview.sk/jobs"
payload := strings.NewReader("{\n \"title\": \"Senior TypeScript Developer\",\n \"description\": \"We are looking for an experienced TypeScript developer...\",\n \"jobUrl\": \"https://company.com/careers/senior-typescript-dev\",\n \"benefits\": \"Health insurance, remote work, flexible hours\",\n \"requiredSkills\": [\n \"TypeScript\",\n \"React\",\n \"Node.js\"\n ],\n \"niceToHaveSkills\": [\n \"Docker\",\n \"AWS\",\n \"GraphQL\"\n ],\n \"languageRequirements\": [\n {\n \"language\": \"EN\",\n \"proficiency\": \"B2\"\n },\n {\n \"language\": \"SK\",\n \"proficiency\": \"C1\"\n }\n ],\n \"education\": [\n \"BACHELOR_LEVEL\",\n \"MASTER_LEVEL\"\n ],\n \"experience\": \"FIVE_TO_10_YEARS\",\n \"contractType\": \"FULL_TIME\",\n \"status\": \"OPEN\",\n \"location\": {\n \"workMode\": \"REMOTE\",\n \"street\": \"Hlavná 123\",\n \"city\": \"Bratislava\",\n \"postalCode\": \"81101\",\n \"countryCode\": \"SK\"\n },\n \"salary\": {\n \"min\": 50000,\n \"max\": 80000,\n \"currency\": \"USD\",\n \"period\": \"YEARLY\"\n },\n \"metadata\": {\n \"externalJobId\": \"JOB-12345\",\n \"department\": \"Engineering\",\n \"hiringManager\": \"Jane Doe\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.instaview.sk/jobs")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"Senior TypeScript Developer\",\n \"description\": \"We are looking for an experienced TypeScript developer...\",\n \"jobUrl\": \"https://company.com/careers/senior-typescript-dev\",\n \"benefits\": \"Health insurance, remote work, flexible hours\",\n \"requiredSkills\": [\n \"TypeScript\",\n \"React\",\n \"Node.js\"\n ],\n \"niceToHaveSkills\": [\n \"Docker\",\n \"AWS\",\n \"GraphQL\"\n ],\n \"languageRequirements\": [\n {\n \"language\": \"EN\",\n \"proficiency\": \"B2\"\n },\n {\n \"language\": \"SK\",\n \"proficiency\": \"C1\"\n }\n ],\n \"education\": [\n \"BACHELOR_LEVEL\",\n \"MASTER_LEVEL\"\n ],\n \"experience\": \"FIVE_TO_10_YEARS\",\n \"contractType\": \"FULL_TIME\",\n \"status\": \"OPEN\",\n \"location\": {\n \"workMode\": \"REMOTE\",\n \"street\": \"Hlavná 123\",\n \"city\": \"Bratislava\",\n \"postalCode\": \"81101\",\n \"countryCode\": \"SK\"\n },\n \"salary\": {\n \"min\": 50000,\n \"max\": 80000,\n \"currency\": \"USD\",\n \"period\": \"YEARLY\"\n },\n \"metadata\": {\n \"externalJobId\": \"JOB-12345\",\n \"department\": \"Engineering\",\n \"hiringManager\": \"Jane Doe\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.instaview.sk/jobs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"title\": \"Senior TypeScript Developer\",\n \"description\": \"We are looking for an experienced TypeScript developer...\",\n \"jobUrl\": \"https://company.com/careers/senior-typescript-dev\",\n \"benefits\": \"Health insurance, remote work, flexible hours\",\n \"requiredSkills\": [\n \"TypeScript\",\n \"React\",\n \"Node.js\"\n ],\n \"niceToHaveSkills\": [\n \"Docker\",\n \"AWS\",\n \"GraphQL\"\n ],\n \"languageRequirements\": [\n {\n \"language\": \"EN\",\n \"proficiency\": \"B2\"\n },\n {\n \"language\": \"SK\",\n \"proficiency\": \"C1\"\n }\n ],\n \"education\": [\n \"BACHELOR_LEVEL\",\n \"MASTER_LEVEL\"\n ],\n \"experience\": \"FIVE_TO_10_YEARS\",\n \"contractType\": \"FULL_TIME\",\n \"status\": \"OPEN\",\n \"location\": {\n \"workMode\": \"REMOTE\",\n \"street\": \"Hlavná 123\",\n \"city\": \"Bratislava\",\n \"postalCode\": \"81101\",\n \"countryCode\": \"SK\"\n },\n \"salary\": {\n \"min\": 50000,\n \"max\": 80000,\n \"currency\": \"USD\",\n \"period\": \"YEARLY\"\n },\n \"metadata\": {\n \"externalJobId\": \"JOB-12345\",\n \"department\": \"Engineering\",\n \"hiringManager\": \"Jane Doe\"\n }\n}"
response = http.request(request)
puts response.read_body{
"id": "123e4567-e89b-12d3-a456-426614174000",
"companyId": "987e6543-e21b-12d3-a456-426614174000",
"title": "Senior TypeScript Developer",
"status": "OPEN",
"createdAt": "2024-11-16T10:30:00Z",
"updatedAt": "2024-11-16T10:30:00Z",
"description": "We are looking for an experienced TypeScript developer...",
"jobUrl": "https://company.com/careers/senior-typescript-dev",
"benefits": "Health insurance, remote work, flexible hours",
"requiredSkills": [
"TypeScript",
"React",
"Node.js"
],
"niceToHaveSkills": [
"Docker",
"AWS"
],
"languageRequirements": [
{
"language": "EN",
"proficiency": "B2"
},
{
"language": "SK",
"proficiency": "C1"
}
],
"education": [
"BACHELORS"
],
"experience": "SENIOR",
"contractType": "FULL_TIME",
"location": {
"workMode": "REMOTE",
"street": "Hlavná 123",
"city": "Bratislava",
"postalCode": "81101",
"countryCode": "SK"
},
"salary": {
"min": 50000,
"max": 80000,
"currency": "USD",
"period": "YEARLY"
},
"metadata": {
"externalJobId": "JOB-12345",
"department": "Engineering"
}
}Creates a job posting scoped to the API key’s company. A job groups contacts, and the hiring focuses that need one require it; outside hiring a conversation needs no job at all.
Overview
The create job endpoint allows you to add new job postings to your recruitment pipeline. Each job must include at minimum a title, description, and status. Jobs can be enhanced with skills requirements, location information, salary details, and more.Use Cases
- Job Posting Creation: Add new positions to your recruitment system
- ATS Integration: Sync jobs from external ATS systems
- Bulk Job Import: Import multiple job postings
- Job Template Creation: Create job templates for recurring positions
Basic Job Creation
{
"title": "Senior Software Engineer",
"description": "We are seeking an experienced software engineer...",
"requiredSkills": ["JavaScript", "React", "Node.js"],
"status": "OPEN"
}
Company Scoping
Jobs are scoped to your API key’s company, and so is everything attached to one.Status Management
Jobs start with a status (typicallyOPEN for active positions). You can update the status later using the Update Job endpoint.
Related Resources
Jobs Resource Guide
Comprehensive guide to job management, including skills, location, and salary configuration
Create Contact
Add contacts to your jobs
List Jobs
View all your job postings
Authorizations
API key for authentication using Bearer scheme
Query Parameters
Required for ATS API keys to specify which company to access. Ignored for standard company API keys.
Body
application/json
Job title
Required string length:
5 - 200Example:
"Senior TypeScript Developer"
Job description
Required string length:
10 - 5000Example:
"We are looking for an experienced TypeScript developer..."
Job URL
Example:
"https://company.com/careers/senior-typescript-dev"
Benefits
Example:
"Health insurance, remote work, flexible hours"
Required skills
Maximum array length:
10Example:
["TypeScript", "React", "Node.js"]
Nice-to-have skills
Maximum array length:
10Example:
["Docker", "AWS", "GraphQL"]
Language requirements with proficiency levels
Maximum array length:
5Show child attributes
Show child attributes
Example:
[
{ "language": "EN", "proficiency": "B2" },
{ "language": "SK", "proficiency": "C1" }
]
Education requirements
Available options:
UNDEFINED, PRIMARY_EDUCATION, SECONDARY_SCHOOL_STUDENT, SECONDARY_WITHOUT_DIPLOMA, SECONDARY_WITH_DIPLOMA, POST_SECONDARY_VOCATIONAL, UNIVERSITY_STUDENT, BACHELOR_LEVEL, MASTER_LEVEL, POSTGRADUATE Example:
["BACHELOR_LEVEL", "MASTER_LEVEL"]
Experience level required
Available options:
UNDEFINED, NO_EXPERIENCE, LESS_THAN_1_YEAR, ONE_TO_3_YEARS, THREE_TO_5_YEARS, FIVE_TO_10_YEARS, TEN_TO_15_YEARS, MORE_THAN_15_YEARS Example:
"FIVE_TO_10_YEARS"
Contract type
Available options:
UNDEFINED, FULL_TIME, PART_TIME, FREELANCE_CONTRACT, TRADE_LICENSE, INTERNSHIP Example:
"FULL_TIME"
Job status
Available options:
UNDEFINED, OPEN, CLOSED Example:
"OPEN"
Job location
Show child attributes
Show child attributes
Salary range with comprehensive validation: min and max must be >= 0, min < max, currency and period are required if min or max is provided, at least one of min or max must be provided if any salary field is present
Show child attributes
Show child attributes
Example:
{
"min": 50000,
"max": 80000,
"currency": "USD",
"period": "YEARLY"
}
Custom metadata for extensibility (max 10KB, 5 levels deep, 50 keys)
Example:
{
"externalJobId": "JOB-12345",
"department": "Engineering",
"hiringManager": "Jane Doe"
}
Response
201 - application/json
Job ID
Example:
"123e4567-e89b-12d3-a456-426614174000"
Company ID
Example:
"987e6543-e21b-12d3-a456-426614174000"
Job title
Example:
"Senior TypeScript Developer"
Job status
Available options:
UNDEFINED, OPEN, CLOSED Example:
"OPEN"
Created timestamp
Example:
"2024-11-16T10:30:00Z"
Updated timestamp
Example:
"2024-11-16T10:30:00Z"
Job description
Example:
"We are looking for an experienced TypeScript developer..."
Job URL
Example:
"https://company.com/careers/senior-typescript-dev"
Benefits
Example:
"Health insurance, remote work, flexible hours"
Required skills
Example:
["TypeScript", "React", "Node.js"]
Nice-to-have skills
Example:
["Docker", "AWS"]
Language requirements with proficiency levels
Show child attributes
Show child attributes
Example:
[
{ "language": "EN", "proficiency": "B2" },
{ "language": "SK", "proficiency": "C1" }
]
Education requirements
Example:
["BACHELORS"]
Experience level
Example:
"SENIOR"
Contract type
Example:
"FULL_TIME"
Location information
Show child attributes
Show child attributes
Salary range
Show child attributes
Show child attributes
Example:
{
"min": 50000,
"max": 80000,
"currency": "USD",
"period": "YEARLY"
}
Custom metadata
Example:
{
"externalJobId": "JOB-12345",
"department": "Engineering"
}