Skip to main content
POST
Submit a job application

Path Parameters

publication_token
string
required

Publication token embedded in the apply_url of the job feed.

Query Parameters

src
string

Sub-source name (added by Easyposting). turnover-it switches to the Turnover-IT format.

Body

application/json

Candidate application payload (version 1.x). Unknown fields are rejected (400), except application_id and status_url, which are kept as the external reference of the application.

version
string
required

Schema version, e.g. "1.2". Any non-empty value is accepted.

Example:

"1.2"

first_name
string
required

Candidate's first name.

Example:

"John"

last_name
string
required

Candidate's last name.

Example:

"Doe"

email
string<email>
required

Candidate's email address.

Example:

"john@doe.site"

country
string
required

Two-character country code (ISO 3166-1 alpha-2 expected; not checked against the list).

Required string length: 2
Example:

"FR"

title
enum<string>

Candidate's title (case-sensitive). Defaults to UNKNOWN.

Available options:
UNKNOWN,
MR,
MS,
MRS,
MISS
Example:

"MR"

office_phone
string

Candidate's office phone number.

Example:

"+33 1 55-55-55-55"

mobile_phone
string

Candidate's mobile phone number.

Example:

"+33 6 55-55-55-55"

home_phone
string

Candidate's home phone number.

Example:

"+33 9 55-55-55-55"

address
string

Candidate's street address.

Example:

"1 rue Champs Bon"

zip_code
string

Candidate's postal code.

Example:

"75001"

town
string

Town where the candidate lives.

Example:

"Paris"

availability
string

When the candidate is available. Known values: now, 15d, 1m, 2m, 3m, >3m, ope, na, date (then send availability_date); other values of up to 4 characters are accepted and ignored.

Maximum string length: 4
Example:

"now"

availability_date
string<date>

Required when availability is "date". Not checked to be in the future.

Example:

"2030-01-10"

cv
object

CV document of the candidate. Optional.

cover
object

Cover letter document of the candidate. Optional. Can also carry any raw candidate information such as assessments.

linkedin_public_url
string<uri>

URL of the candidate's LinkedIn profile; http:// is added when the scheme is missing.

Example:

"https://www.linkedin.com/in/username/"

experience
integer

Years of experience.

Required range: 0 <= x <= 100

Response

Application submitted.

version
enum<string>
Available options:
1.0
status
enum<string>
Available options:
ok