Save a Candidate é um POST em /premium/v2/{account_id}/linkedin/recruiter/projects/{project_id}/pipeline/candidate/save, parte da família linkedin da API Premium da MakeHybrid. Toda requisição leva a sua própria chave em um cabeçalho X-API-KEY; a chave decide qual organização você é e, portanto, quais contas do LinkedIn você pode citar.
Esta família repassa a requisição para a superfície do próprio LinkedIn, então o que volta tem o formato que o LinkedIn dá, não nós.
A requisição
curl -X POST "https://makehybrid.com/premium/v2/$ACCOUNT_ID/linkedin/recruiter/projects/$PROJECT_ID/pipeline/candidate/save" \
-H "X-API-KEY: $MAKEHYBRID_KEY" \
-H "content-type: application/json" \
-d '{}'
O que vai no caminho
- account_id — a conta do LinkedIn conectada com a qual agir. Precisa ser uma que a sua própria chave conectou; qualquer outro id responde 404.
- project_id — um id devolvido por uma chamada anterior desta família.
O que volta quando não funciona
- 401 — a chave está faltando, está errada ou foi revogada.
- 402 — o plano não está pago. O Premium responde isso quando o teste acaba.
- 404 — ou a coisa não está lá, ou o id da conta não é seu. As duas respostas são a mesma de propósito, para que ids não possam ser sondados.
- 429 — requisições demais, ou o LinkedIn limitando a conta. Esperar é o único remédio; tentar de novo antes só alonga.
- 503 — o LinkedIn, ou o salto na frente dele, não respondeu. O corpo carrega o status cru que ele viu.
Todo erro é JSON no mesmo formato: {"type":"errors/<code>","status":<n>,"detail":"..."} — então um único tratador cobre todos, e o detail foi escrito para ser mostrado a uma pessoa.
Pedir a um assistente
Esta operação também é uma ferramenta MCP. Cole https://makehybrid.com/mcp/<sua chave de API> no Claude, no ChatGPT ou em qualquer assistente que fale MCP e peça o que quiser em português — o assistente escolhe a chamada, preenche os ids e lê a resposta para você. Não há nada para instalar.
Em qual plano está
O plano Premium, em /premium. $9 por conta do LinkedIn conectada por mês, $7 a partir de dez contas e $5 a partir de mil, com 30 dias de teste para uma conta.