Créer un candidat

Vous pouvez créer un candidat grâce à l'API.

Important

L'URL racine est ici https://careers.flatchr.io

Requête

Cette méthode permet de créer un candidat :

Par une requête sur l'API

  POST vacancy/candidate/json

Via un système web

  POST vacancy/candidate/custom

Paramètres

Paramètre	In	Type	Obligatoire	Description	Exemple
vacancy	payload	string	✔️	slug de l'offre	vyja3k5rrnlnqwe-technicien-h-f
firstname	payload	string	✔️	firstname du candidat	Johnny
lastname	payload	string	✔️	lastname du candidat	Doe
token	payload	string	✔️	Token
email	payload	string		email du candidat	john.doe@mail.fr
phone	payload	integer		phone du candidat	+33123456789
type	payload	string	✔️	Définit le type de CV (link ou document)	link
resume	payload	base64 / url	✔️	Url si "type": "link", Objet si "type": "document"	storage.s3.eu-west-1.amazonaws.com/CV/5b400fab-679811f70b0e/CV_John_Doe.pdf
comment	payload	string		Lettre de motivation du candidat
offerer_id	payload	integer		Offerer id	75
urls	payload	object		urls du candidat
legalNewsletterPartners	payload	boolean		Opt-in newsletter (autorisation d'envoie d'une Newsletter)	false
similarities	payload	boolean		Retourne offres similaires	false
response_text	payload	string		Modifier la réponse réglée
answers	payload	[answer]		Réponses aux questions/tags du formulaire
user_id	payload	string		Clé utilisateur (Paramètres ➝ Avancés ➝ API)	lVq5r6pYLD9AmMvP

Astuce

Vous pouvez tester vos requêtes de création de candidats grâce à la méthode suivante :

    POST /vacancy/candidate/test

Exemple de requête

Avec un fichier PDF

Créer un candidat avec le lien d'un CV

  curl -X POST https://careers.flatchr.io/vacancy/candidate/json
      -H "Authorization: Bearer {token}"
      -H 'Content-Type: application/json'
      -d '{
          "vacancy": "vyja3k5rrnlnqwe-technicien-h-f",
          "firstname": "Johnny",
          "lastname": "Doe",
          "token": "{token}",
          "type": "document",
          "resume": {
            "data": "{fichier encodé en base 64}",
            "fileName": "CV_John_Doe",
            "contentType": "application/pdf"
          }
        }'

Avec un lien vers le CV

Créer un candidat avec le lien d'un CV

  curl -X POST https://careers.flatchr.io/vacancy/candidate/json
      -H "Authorization: Bearer {token}"
      -H 'Content-Type: application/json'
      -d '{
              "vacancy": "vyja3k5rnlnqwe-technicien-h-f",
              "firstname": "John",
              "lastname": "Doe",
              "token": "{token}",
              "type": "link",
              "resume": "storage.s3.eu-west-1.amazonaws.com/CV/5b400fab-679811f70b0e/CV_John_Doe.pdf"
            }' 

D'autres exemples sont disponibles sur Gitlab :

Réponse

Name	Type	Description
status	HTTP Status
response	string	Ex: "applicant created"