Créer une offre d'emploi

Ce guide vous explique comment créer une nouvelle offre d'emploi sur notre plateforme.

Prérequis

• Une entreprise existante dans Canada Motor Jobs ainsi que son ID
• Les informations détaillées du poste à pourvoir

Point d'accès

POST https://canadamotorjobs.com/api/v1/{locale}/job-listings/create

Paramètres

Paramètre	Type	Description	Default
ref_id	string, nullable	Identifiant de référence de l'offre dans votre système	null
business_id	string, requis	L'ID de l'entreprise	-
confidential	boolean, optionnel	Si l'offre est confidentielle	false
department_id	string, optionnel	L'ID du département	null
section_id	string, optionnel	L'ID de la section	null
job_title_id	string, optionnel, requis si job_title_name n'est pas fourni	L'ID du titre de poste. Il est préférable de fournir l'ID du titre de poste plutôt que le nom afin d'associé l'offre convenablement aux sections du site et les infolettres. Vous pouvez fournir un titre de poste (job_title_name) différent même si vous fournissez l'ID du titre de poste.	null
job_title_name	string, optionnel, requis si job_title_id n'est pas fourni	Le nom du titre de poste souhaitez	null
experience_required	integer, nullable	L'expérience requise pour le poste	null
salary_shown	boolean, optionnel	Si le salaire est affiché	true
salary	float, optionnel	Le salaire de l'offre, si null la valeur par défaut associée au titre d'emploi sera utilisée. Il est préférable de fournir vous même la valeur du salaire plutôt que de laisser le système déterminer la valeur par défaut.	35000.00
salary_method_id	string, optionnel	Ce qui sera affiché au dessus du salaire • 'possible' : Possibilité de salaire • 'experience' : Selon l'expérience • 'collective_agreement' : Selon convention collective	'possible'
salary_before_text	string, optionnel	Texte affiché devant le salaire • 'upTo' : Jusqu'à • 'startingAt' : À partir de • 'none' : ''	'upTo'
commissions	string, optionnel	Texte affiché après le salaire ou au lieu du salaire • 'none' : '' • 'only' : 'Commissions uniquement' • 'plus' : '+ comissions'	'none'
bonuses	string, optionnel	Texte affiché après le salaire ou au lieu du salaire • 'none' : '' • 'plus' : '+ bonuses'	'none'
vacations	integer, min:2, max:36,optionnel	Nombre de semaines de congés par année	null
hiring_bonus_value	float, optionnel	Montant de la prime à l'embauche si disponible	null
hiring_bonus_timeframe	string, optionnel	Unité pour le délais avant de recevoir la prime à l'embauche. Peut être laissé vide si c'est immédiatement ou si vous ne souhaitez pas afficher le délais. • 'day' : Par jour • 'week' : Par semaine • 'month' : Par mois • 'year' : Par année	null
hiring_bonus_period	integer, optionnel	Nombre de période pour le délais avant de recevoir la prime à l'embauche. Peut être laissé vide si c'est immédiatement ou si vous ne souhaitez pas afficher le délai. (example: hiring_bonus_period de 12 avec hiring_bonus_timeframe de 'week' signifie que la prime sera versée 12 semaines après l'embauche)	null
job_type	string, optionnel	L'ID du type d'emploi	permanent
workplace	string, optionnel	L'ID du lieu de travail	location
custom_description	string, optionnel	Description de l'offre d'emploi	null
custom_details	string, optionnel	Détails plus spécifique relatifs au candidat recherché	null
ai_assisted	boolean, optionnel	Si vous souhaitez que notre intelligence artificielle génère ou optimise votre custom_description à votre place	false
ai_assisted_instruction	string, optionnel	Instructions pour notre intelligence artificielle pour générer ou optimiser votre custom_description	null
auto_translate	boolean, optionnel	Si vous souhaitez que notre intelligence artificielle traduise votre offre d'emploi en anglais et espagnol automatiquement, si (false), vous devrez ajouter les traductions manuellement après la création de l'offre, vous pouvez laisser activer et modifier les textes par la suite.	true
callback_application_url	string, nullable	URL de callback pour les notifications de candidature	null

Codes de réponse

Code	Message	Description
JOB_LISTING_CREATED	L'offre d'emploi a été créée avec succès	Retourne les informations de l'offre d'emploi créée
INVALID_PARAMETERS	Les paramètres fournis sont invalides	Retourne les informations de l'erreur
NOT_AUTHORIZED	Vous n'avez pas les permissions nécessaires	Vous n'avez pas les permissions nécessaires pour créer une offre d'emploi pour cette entreprise
ERROR_SERVER	Le serveur a rencontré une erreur lors de la création de l'offre d'emploi	Retourne les informations de l'erreur