curl --request POST \
--url https://api.gospott.com/job-boards \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"vacancyId": "<string>",
"jobBoardProvider": "SPOTT",
"targetStageId": "<string>",
"jobDescriptionId": "<string>",
"linkedInProjectUrl": "<string>",
"applyUrl": "<string>"
}
'import requests
url = "https://api.gospott.com/job-boards"
payload = {
"vacancyId": "<string>",
"jobBoardProvider": "SPOTT",
"targetStageId": "<string>",
"jobDescriptionId": "<string>",
"linkedInProjectUrl": "<string>",
"applyUrl": "<string>"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
vacancyId: '<string>',
jobBoardProvider: 'SPOTT',
targetStageId: '<string>',
jobDescriptionId: '<string>',
linkedInProjectUrl: '<string>',
applyUrl: '<string>'
})
};
fetch('https://api.gospott.com/job-boards', 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.gospott.com/job-boards",
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([
'vacancyId' => '<string>',
'jobBoardProvider' => 'SPOTT',
'targetStageId' => '<string>',
'jobDescriptionId' => '<string>',
'linkedInProjectUrl' => '<string>',
'applyUrl' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$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.gospott.com/job-boards"
payload := strings.NewReader("{\n \"vacancyId\": \"<string>\",\n \"jobBoardProvider\": \"SPOTT\",\n \"targetStageId\": \"<string>\",\n \"jobDescriptionId\": \"<string>\",\n \"linkedInProjectUrl\": \"<string>\",\n \"applyUrl\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
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.gospott.com/job-boards")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"vacancyId\": \"<string>\",\n \"jobBoardProvider\": \"SPOTT\",\n \"targetStageId\": \"<string>\",\n \"jobDescriptionId\": \"<string>\",\n \"linkedInProjectUrl\": \"<string>\",\n \"applyUrl\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gospott.com/job-boards")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"vacancyId\": \"<string>\",\n \"jobBoardProvider\": \"SPOTT\",\n \"targetStageId\": \"<string>\",\n \"jobDescriptionId\": \"<string>\",\n \"linkedInProjectUrl\": \"<string>\",\n \"applyUrl\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>"
}{
"status": 0,
"message": "<string>",
"requestId": "<string>"
}{
"status": 0,
"message": "<string>",
"requestId": "<string>"
}{
"status": 0,
"message": "<string>",
"requestId": "<string>"
}Create job board posting
Create and publish a job board posting for a job. The job must have non-empty job description content before it can be published. Optionally provide jobDescriptionId to select which job description the posting uses; when omitted the oldest job description of the vacancy is selected. Optionally provide targetStageId to choose the stage inbound applications land in; when omitted the default application stage of the job’s track is used, falling back to the first stage of that track when no default is configured.
curl --request POST \
--url https://api.gospott.com/job-boards \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"vacancyId": "<string>",
"jobBoardProvider": "SPOTT",
"targetStageId": "<string>",
"jobDescriptionId": "<string>",
"linkedInProjectUrl": "<string>",
"applyUrl": "<string>"
}
'import requests
url = "https://api.gospott.com/job-boards"
payload = {
"vacancyId": "<string>",
"jobBoardProvider": "SPOTT",
"targetStageId": "<string>",
"jobDescriptionId": "<string>",
"linkedInProjectUrl": "<string>",
"applyUrl": "<string>"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
vacancyId: '<string>',
jobBoardProvider: 'SPOTT',
targetStageId: '<string>',
jobDescriptionId: '<string>',
linkedInProjectUrl: '<string>',
applyUrl: '<string>'
})
};
fetch('https://api.gospott.com/job-boards', 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.gospott.com/job-boards",
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([
'vacancyId' => '<string>',
'jobBoardProvider' => 'SPOTT',
'targetStageId' => '<string>',
'jobDescriptionId' => '<string>',
'linkedInProjectUrl' => '<string>',
'applyUrl' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$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.gospott.com/job-boards"
payload := strings.NewReader("{\n \"vacancyId\": \"<string>\",\n \"jobBoardProvider\": \"SPOTT\",\n \"targetStageId\": \"<string>\",\n \"jobDescriptionId\": \"<string>\",\n \"linkedInProjectUrl\": \"<string>\",\n \"applyUrl\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
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.gospott.com/job-boards")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"vacancyId\": \"<string>\",\n \"jobBoardProvider\": \"SPOTT\",\n \"targetStageId\": \"<string>\",\n \"jobDescriptionId\": \"<string>\",\n \"linkedInProjectUrl\": \"<string>\",\n \"applyUrl\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gospott.com/job-boards")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"vacancyId\": \"<string>\",\n \"jobBoardProvider\": \"SPOTT\",\n \"targetStageId\": \"<string>\",\n \"jobDescriptionId\": \"<string>\",\n \"linkedInProjectUrl\": \"<string>\",\n \"applyUrl\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>"
}{
"status": 0,
"message": "<string>",
"requestId": "<string>"
}{
"status": 0,
"message": "<string>",
"requestId": "<string>"
}{
"status": 0,
"message": "<string>",
"requestId": "<string>"
}Authorizations
API key for authentication. Get your API key from Settings → API Keys in your Spott dashboard.
Body
1SPOTT The application stage inbound applications on this posting land in. Defaults to the default application stage of the job's track, or the first stage of that track when no default is set.
11Response
Job board posting created successfully.
1Was this page helpful?