FlashPost StepStone DK documentation

Create listing

full example minimal example

Field	Mandatory	Description
anonymous	forbidden	cannot be used for this job board
customerId	required	ID number
jobBoardIds	required	ID number
jobDetails	required	Job details
providerReferenceId	required	string length must be between 1 and 255
templateId	optional	string
walletId	optional	ID number will be provided by your Sales Representative if needed

Update listing

full example minimal example

Field	Mandatory	Description
jobBoardIds	required	ID number
jobDetails	required	Job details
templateId	optional	string

Job details

Field	Mandatory	Description
applicationMethod	required	Application method
categories	required	Categories
description	required	Description
jobAddress	optional	Job address
language	required	string ISO 639 alpha-2 language code
numberOfVacancies	optional	integer number cannot be lower than 1
salary	optional	Salary
title	required	string length must be between 1 and 255

Application method

must contain at least one of the following: applicationUrl, email

Field	Mandatory	Description
applicationUrl	optional	string must have a valid URL format (i.e. https://example.org/page) length must be between 1 and 2083
email	optional	string must have a valid email format length must be between 1 and 255

Categories

Field	Mandatory	Description
contractType	optional	ID number See also: Available IDs
education	optional	ID number See also: Available IDs
experience	optional	ID number See also: Available IDs
geography	required	array of ID numbers See also: Available IDs
sector	optional	ID number See also: Available IDs
workfield	required	ID number See also: Available IDs

Description

Field	Mandatory	Description
structuredDescription	required	Structured description

Job address

Field	Mandatory	Description
city	optional	string length must be between 1 and 255
country	optional	string ISO 3166 alpha-2 country code.

Salary

information required only in case salary property is specified for the job listing
the information submitted may be converted to match job board's requirements
salary's max value cannot be higher than 160% of salary's min

Field	Mandatory	Description
currency	required	string ISO 4217 currency code See also: List of accepted currency codes
hidden	forbidden	cannot be used for this job board
max	required	number
min	required	number
period	required	one of: "MONTH", "YEAR"

Structured description

Field	Mandatory	Description
companyIntroduction	required	string length must be between 1 and 2500
companyIntroductionHeader	optional	string length must be between 1 and 255
description	required	string length must be between 1 and 2500
descriptionHeader	optional	string length must be between 1 and 255
offer	required	string length must be between 1 and 2500
offerHeader	optional	string length must be between 1 and 255
requiredProfile	required	string length must be between 1 and 2500
requiredProfileHeader	optional	string length must be between 1 and 255
typeOfContent	optional	one of: "HTML", "TEXT"