FlashPost StepStone AT documentation

Create listing

full example minimal example

Field	Mandatory	Description
anonymous	forbidden	cannot be used for this job board
companyDetails	optional	Company details
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
companyDetails	optional	Company details
jobBoardIds	required	ID number
jobDetails	required	Job details
templateId	optional	string

Company details

Field	Mandatory	Description
companyWebsiteUrl	optional	string must have a valid URL format (i.e. https://example.org/page) length must be between 1 and 100
contactAddress	optional	Contact address
contactEmail	optional	string must have a valid email format length must be between 1 and 255
contactName	optional	string length must be between 1 and 255
contactPhone	optional	string length must be between 7 and 255

Job details

Field	Mandatory	Description
applicationMethod	required	Application method
categories	required	Categories
description	required	Description
jobAddress	required	Job address
keywords	optional	array of string each keyword must be unique
language	required	one of "en", "de" ISO 639 alpha-2 language code
numberOfVacancies	optional	integer number cannot be lower than 1
salary	required	Salary
title	required	string length must be between 1 and 150
trackingPixelUrl	optional	string must have a valid URL format (i.e. https://example.org/page) length must be between 1 and 2083

Contact address

Field	Mandatory	Description
city	optional	string length must be between 1 and 255
country	optional	string ISO 3166 alpha-2 country code. length must be exactly 2
postcode	optional	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	required	cannot be updated ID number See also: Available IDs
education	optional	ID number See also: Available IDs
experience	required	cannot be updated ID number See also: Available IDs
geography	required	cannot be updated array of ID numbers See also: Available IDs
sector	required	cannot be updated ID number See also: Available IDs
workfield	required	cannot be updated ID number See also: Available IDs

Description

Field	Mandatory	Description
structuredDescription	required	Structured description

Job address

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

Salary

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
additionalInformationForCandidates	optional	string length must be between 1 and 2500
additionalInformationForCandidatesHeader	optional	string length must be between 1 and 255
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"