Evento: Vaga criada (JOB_ADDED)

Dispara quando uma vaga é criada na sua conta.

Novo nos webhooks? Veja a visão geral para o conceito (registrar uma vez, receber sempre que a ação ocorre).

Criando o webhook

Registre um webhook para o evento JOB_ADDED (Criar webhook):

curl -X POST https://api.inhire.app/integrations/webhooks \
  -H "Authorization: Bearer SEU_ACCESS_TOKEN" \
  -H "X-Tenant: suaempresa" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Vaga criada",
    "event": "JOB_ADDED",
    "url": "https://seu-sistema.com/webhooks/inhire/vaga-criada",
    "headers": { "Authorization": "Bearer UM_SEGREDO_SEU" }
  }'

A partir daí, o InHire chamará a sua URL sempre que este evento ocorrer. Para filtrar quais ocorrências recebe, adicione rules (ver abaixo).

Payload

{
  "tenantId": "suaempresa",
  "jobId": "5dfd3a1e-a5c3-4e53-a3f4-cdb4e311d315",
  "jobName": "Analista de Logística",
  "jobOriginId": "REQ-123",
  "additionalLocations": ["Rio de Janeiro, RJ"],
  "customFields": {},
  "userId": "u-123",
  "userName": "Recrutador"
}

Campo	Descrição
jobId / jobName	Identificação da vaga criada
jobOriginId	Identificador externo, se houver (opcional)
customFields	Campos personalizados da vaga (opcional)
additionalLocations	Localizações adicionais (opcional)
userId / userName	Quem criou a vaga

Quando usar

• Publicar a vaga automaticamente em um job board próprio ou site externo.
• Criar um registro correspondente em um ERP/ATS secundário.
• Notificar um canal sobre cada nova vaga aberta.

Filtrando com rules

// Apenas vagas que tenham um identificador externo
{ "jobOriginId": { "operator": "!=", "value": "" } }

Exemplo: recebendo o evento e buscando a vaga

O payload traz o jobId. Use-o para buscar os dados completos da vaga na API do InHire:

import express from "express";
import axios from "axios";

const app = express();
app.use(express.json());

// Cliente autenticado da API do InHire (use um service account — ver guia de Autenticação)
const inhire = axios.create({
  baseURL: "https://api.inhire.app",
  headers: {
    Authorization: `Bearer ${process.env.INHIRE_TOKEN}`,
    "X-Tenant": "suaempresa",
  },
});

app.post("/webhooks/inhire/vaga-criada", async (req, res) => {
  // Valide a origem usando o header secreto configurado no webhook
  if (req.headers.authorization !== "Bearer UM_SEGREDO_SEU") {
    return res.sendStatus(401);
  }
  res.sendStatus(200); // responda rápido e processe de forma assíncrona

  const { jobId } = req.body;

  const { data: vaga } = await inhire.get(`/jobs/${jobId}`); // a vaga

  console.log(`Nova vaga criada: "${vaga.name}" (status: ${vaga.status})`);

  // ...sua lógica aqui (ex.: publicar em um job board externo)
});

app.listen(3000);

Endpoint usado: Obter vaga.