후보자 저장은(는) /linkedin/v2/{account_id}/linkedin/recruiter/projects/{project_id}/pipeline/candidate/save에 대한 POST이며, MakeHybrid API의 linkedin 계열에 속합니다. 모든 요청은 X-API-KEY 헤더에 자신의 키를 싣습니다. 키가 어느 조직인지를 정하고, 따라서 어떤 LinkedIn 계정을 지목할 수 있는지도 정합니다.
이 계열은 요청을 LinkedIn 자체 표면으로 그대로 넘깁니다. 그래서 돌아오는 것의 모양은 우리가 아니라 LinkedIn이 정합니다.
요청
curl -X POST "https://makehybrid.com/linkedin/v2/$ACCOUNT_ID/linkedin/recruiter/projects/$PROJECT_ID/pipeline/candidate/save" \
-H "X-API-KEY: $MAKEHYBRID_KEY" \
-H "content-type: application/json" \
-d '{}'
경로에 들어가는 것
- account_id — 그 이름으로 동작할, 연결된 LinkedIn 계정. 반드시 자신의 키로 연결한 것이어야 하며, 그 밖의 id는 모두 404를 받습니다.
- project_id — 이 계열의 앞선 호출이 돌려준 id.
안 될 때 돌아오는 것
- 401 — 키가 없거나, 틀렸거나, 폐기되었습니다.
- 402 — 요금제가 결제되지 않았습니다. 체험이 끝나면 MakeHybrid API가 이것을 돌려줍니다.
- 404 — 그것이 없거나, 계정 id가 당신 것이 아니거나. id를 떠볼 수 없도록 둘 다 일부러 같은 답을 줍니다.
- 429 — 요청이 너무 많거나 LinkedIn이 그 계정을 누르고 있습니다. 기다리는 것 말고는 방법이 없고, 일찍 다시 시도할수록 길어집니다.
- 503 — LinkedIn, 또는 그 앞의 홉이 응답하지 않았습니다. 본문에는 그쪽이 본 상태 코드가 그대로 담깁니다.
모든 오류는 같은 모양의 JSON입니다: {"type":"errors/<code>","status":<n>,"detail":"..."} — 핸들러 하나로 전부 받을 수 있고, detail은 사람에게 보여 주려고 쓴 문장입니다.
대신 어시스턴트에게 부탁하기
이 작업은 MCP 도구이기도 합니다. https://makehybrid.com/linkedin/mcp/<내 API 키>를 Claude나 ChatGPT, 또는 MCP를 말하는 아무 어시스턴트에나 붙여 넣고 평범한 말로 부탁하세요 — 어시스턴트가 호출을 고르고 id를 채우고 답을 읽어 줍니다. 설치할 것은 없습니다.
프로젝트 룸에서
프로젝트 룸에서 내 AI 에이전트의 「사용할 수 있는 서버」 아래 MakeHybrid를 체크하면, 대화에 필요할 때마다 에이전트가 “후보자 저장”을(를) 도구로 호출합니다. 대상은 조직이 연결한 LinkedIn 계정입니다. 룸의 모두가 에이전트가 무엇을 요청했고 무엇이 돌아왔는지 볼 수 있습니다. 평범한 말로 부탁하세요. 여기서는 에이전트의 이름이 @scout입니다:
자주 묻는 질문
AI 에이전트가 나 대신 “후보자 저장”을(를) 호출할 수 있나요?
네. MCP를 지원하는 어시스턴트라면 위의 주소로 호출할 수 있고, MakeHybrid를 체크한 프로젝트 룸의 내 AI 에이전트도 호출할 수 있습니다. 룸의 내장 에이전트는 할 수 없습니다. 조언만 할 뿐 내 LinkedIn 키를 갖고 있지 않습니다.
룸 밖에서, 내 코드로도 되나요?
네. 위의 요청은 AI 에이전트의 도구가 호출하는 것과 같은 작업이며, 답도 오류도 같습니다. 어느 길로 들어오든 어떤 LinkedIn 계정을 지목할 수 있는지는 키가 정합니다.
내 브랜드의 룸에서도 되나요?
네. 화이트 라벨 주소에서는 도구가 내 제품 이름으로 표시되며, 같은 규칙에 따라 같은 계정에 닿습니다.
AI 에이전트가 이 일을 하기 전에 사람이 승인할 수 있나요?
AI 에이전트의 지침에 써 두세요. 하려는 일을 말하고, 룸의 사람이 진행하라고 할 때까지 기다리라고요. 룸에서는 모든 답변이 모두에게 보이므로, LinkedIn에서 무언가 바뀌기 전에 그 요청이 눈에 띕니다.
어느 요금제인지
MakeHybrid API, /linkedin에서. 연결된 LinkedIn 계정 하나당 월 9달러, 열 개부터는 7달러, 천 개부터는 5달러. 계정 하나에 대한 30일 체험 포함.