Conceitos Importantes!

As vagas de candidatura rápida permitem que a pessoa candidata forneça apenas informações essenciais como: nome completo, CPF ou documento de Identificação (para estrangeiros), e-mail, celular, perfil do LinkedIn (opcional), perguntas customizadas criadas pela empresa e arquivos de currículo. Para utilização das vagas de candidatura rápida algumas regras são aplicadas, como:

• Vagas de candidatura rápida não permitem o uso de template.
• Não podem ser publicadas como banco de talentos e nem conter essa expressão no nome.
• Não podem ser publicadas como confidenciais ou internas.
• O status quickapplication não pode ser alterado após a criação da vaga.

Gerando o token

Para utilizar este fluxo, é necessário utilizar o Bearer Token gerado nas configurações avançadas da plataforma. Acesse nossa seção de autenticação para saber como gerar o token de autenticação.

No momento de gerar o token habilite os seguintes endpoints da V1:

• Company Branches
• Company Departments
• Jobs
• Job Roles

📘

Atenção!

A criação de uma vaga através da API sempre irá criar com status "draft", se a sua necessidade é que a vaga entre na Gupy como aprovada ou publicada será necessário chamar outro endpoint para alterar o status após a criação. Consulte esse fluxo clicando aqui

Não há tratativas para caracteres especiais, a informação será cadastrada conforme foi enviada. Exemplo: se no nome da vaga houver a palavra "P&D" a mesma será cadastrada e exibida como "P&D"

📘

Importante!

A criação dessa vaga seguirá os mesmas orientações descritas na documentação: criando uma vaga padrão na Gupy. No entanto, contará com um campo adicional que permitirá o formato de candidatura rápida (quickApply).

Fluxo de integração:

Fazendo a requisição e criando uma nova vaga

Faça a requisição para o endpoint Creating a job, garantindo o preenchimento dos campos obrigatórios e levando as regras de negócio da candidatura rápida em consideração. Para criar uma vaga do tipo candidatura rápida defina o campo quickApply = true.

Exemplo de requisição:

curl --request POST \
     --url https://api.gupy.io/api/v1/jobs \
     --header 'accept: application/json' \
     --header 'authorization: Bearer XXXXXXXX-XXXX-XXXX-XXXXXXXXXXXXc' \
     --header 'content-type: application/json' \
     --data '
{
  "type": "vacancy_type_effective",
  "publicationType": "external",
  "name": "Vaga com candidatura rapida",
  "quickApply": true,
  "numVacancies": 4,
  "departmentId": 5962,
  "roleId": 7873
}
'

Exemplo de resposta:

{
  "id": 9138694,
  "code": "0266-9138694",
  "name": "Vaga com candidatura rapida",
  "status": "draft",
  "type": "vacancy_type_effective",
  "publicationType": "external",
  "numVacancies": 4,
  "departmentId": 5962,
  "departmentName": "Administrativo (ML)",
  "roleId": 7873,
  "roleName": "Assistente",
  "subsidiaryId": null,
  "subsidiaryName": null,
  "createdAt": "2025-05-12T14:44:00.228Z",
  "updatedAt": "2025-05-12T14:44:00.351Z",
  "hiringDeadline": null,
  "description": null,
  "responsibilities": null,
  "prerequisites": null,
  "additionalInformation": null,
  "notes": null,
  "disabilities": false,
  "addressStreet": null,
  "addressNumber": null,
  "addressCity": null,
  "addressState": null,
  "addressStateShortName": null,
  "addressCountry": null,
  "addressCountryShortName": null,
  "addressComplements": null,
  "addressDistrict": null,
  "addressZipCode": null,
  "addressLatitude": null,
  "addressLongitude": null,
  "remoteWorking": false,
  "workplaceType": "on-site",
  "reason": null,
  "image": null,
  "socialMediaImage": null,
  "applicationDeadline": "2025-07-11",
  "careerPageId": null,
  "careerPageName": null,
  "vacancyCodes": [],
  "managerId": null,
  "managerName": null,
  "managerEmail": null,
  "recruiterId": null,
  "recruiterName": null,
  "recruiterEmail": null,
  "salary": {
    "currency": null,
    "startsAt": null,
    "endsAt": null
  }

Informações importantes:

Para vagas deste tipo:

• Para inserir candidatos manualmente utilizar o endpoint: https://developers.gupy.io/v2.0/reference/applicationscontroller_createquickapplyapplication
• Os dados das candidaturas rápidas podem ser consultados normalmente através da API V2 de listagem de candidatos, disponíveis no campo expand. A documentação pode ser acessada clicando aqui.

Possíveis Erros:

1. Ao tentar criar uma vaga do tipo candidatura rápida com template, o response retornará a seguinte mensagem:

{  
  "title": "Business Error",  
  "detail": "quick_apply_cannot_have_a_template",  
  "status": 400  
}

2. Ao tentar criar uma vaga do tipo candidatura rápida como banco de talentos, o response retornará a seguinte mensagem:

{  
  "title": "Business Error",  
  "detail": "quick_apply_job_cannot_be_talent_pool",  
  "status": 400  
}

3. Ao tentar alterar o status quickapply para false, o response retornará a seguinte mensagem:

{
  "title": "Validation Error",
  "detail": "Unable to update quickApply field",
  "status": 400
}