POST : Create job

This endpoint lets you create one job for a given company, inside media.

This endpoint requires :

• brand_admin, media_admin or media_partner roles.

• r_w_jobs scope.

Important informations

  • This endpoint have a short rate limits → Rate limits

  • By default, all job published have a maximum duration time of 90 days. After this period they are automatically pass to archived

  • For Data management reason, you can create job only on company currently published inside a media. The error retrieve in this case company-not-published

Create new job

POST https://api.piloty.fr/jobs

Request Body - required

Name
Type
Description

media_public_id*

string

eg: 'acme_media'

company_public_id*

string

eg: 'acme_company'

name*

string

eg: "ACME Company"

contract_id*

string

from List Contracts

job_category_id*

string

from List Job Categories

localisation*

string

eg: "Paris, Ile de France, France"

description_job*

string

eg: "We are looking for ...."

application_method*

enum

external_apply | internal_apply

Request Body - other

Name
Type
Description

application_url

url

Required if application_method === external_apply

state

enum

draft | published | archived

worktime_id

string

from List Worktimes

remote_policy_id

string

from List Remote policies

education_id

string

from List Educations

experience_id

string

from List Experiences

salary

string

max 30 characters

position_level

string

employee | executive

description_company

string

eg: "ACME company is ...."

description_profile

string

eg: "As a ...."

description_benefits

string

eg: "At ACME Company ...."

description_process

string

eg: "Hiring process ..."

manager_emails

string

The email list will be notified when an automatic action is performed on the job. Separator: ;

Limit: 4 emails.

recruiter_emails

string

The email list will be notified when an application is made on the job.

Separator: ;

Limit: 4 emails.

Request example

PreviousGET : Retrieve job openedNextPATCH : Update job

Last updated