creating an application

Essa documentação se refere ao glossário do endpoint de criação de aplicações à uma vaga (método POST)

Endpoint do escopo de Applications

Create Application - Cria uma aplicação (candidatura) a partir de uma vaga e um candidato. Pode criar a candidatura utilizando o id do candidato (quando o candidato já está cadastrado em alguma vaga na Gupy) ou fazendo uma inserção manual do candidato (quando ainda não existe informação sobre o candidato).

Logo, se passarmos o candidateId **_não preencheremos o _manualCandidate** e vice-versa.

Todo candidato inserido manualmente em uma vaga através da plataforma receberá um e-mail de convite para essa vaga, é necessário que o candidato aceite o convite clicando no link enviado pelo e-mail, só assim seus dados ficarão disponíveis na candidatura.

Se você está realizando a inserção manual através desse endpoint, é necessário utilizar o serviço Invite the candidate para enviar o convite ao candidato.

Abaixo, temos os campos que podem ser preenchidos na criação de uma vaga via API

CAMPO BACKENDOPÇÕES NO BACKENDCAMPO NO FRONTENDObservações
jobIdNúmero gerado automaticamente pela Gupy ao criar uma vaga (conhecido como jobId). Ao abrir uma vaga na plataforma, o Id pode ser identificado na URL após /companies/jobs/Retorno results.id ao criar uma vaga utilizando o endpoint creating a job
notesAnotações no perfil da pessoa candidata
candidateIdId gerado automaticamente pela plataforma quando uma pessoa realiza o cadastro em qualquer vaga da Gupy e assim adentra a base de dados.
manualCandidate.nameNome do candidato
manualCandidate.lastNameSobrenome do candidato
manualCandidate.emailAo acessar uma vaga é o botão "Adicionar" logo acima das etapas da vaga. O primeiro campo que aparecerá para inserir será o e-mail do candidato.Caso o e-mail já exista na base da Gupy, será gerado um erro na tentativa de criá-lo (statusCode 409). Neste caso, será retornado o candidateId e a partir dele, você pode fazer uma nova chamada para criar a candidatura para a vaga
manualCandidate.mobileNumberTelefone celular do candidato
manualCandidate.linkedinProfileUrlLink para o perfil do candidato no LinkedIn (se houver)
manualCandidate.insertionSourcecandidate_active_contact, events hunting, market_referral_consulting employee_referral, chrome_extensionFonte da inserção manual do candidato.