---
title: "Add or move a Recruiter candidate"
method: POST
path: "/v1/actions/move_recruiter_candidate"
tags: ["Recruiter"]
---

# Add or move a Recruiter candidate

`POST /v1/actions/move_recruiter_candidate`

## Request

- Base URL: `https://api.heyreagent.com`
- URL: `https://api.heyreagent.com/v1/actions/move_recruiter_candidate`
- Auth: HTTP bearer

Put one person into a hiring project's pipeline, or move them to another stage.

The published definition calls the person's id only "the ID of the user"; that it is the Recruiter id is this tool's own wording.

Docs: https://heyreagent.com/docs/actions/move_recruiter_candidate

## Request body

- object
  - `candidateId` string, required: The person's Recruiter id (AE…).
  - `action` 'add_candidate' | 'add_applicant' | 'change_stage', required: add_candidate: add someone you sourced. add_applicant: add someone who applied. change_stage: move someone already in the pipeline.
  - `hiringProjectId` string, required: The hiring project (from list_hiring_projects).
  - `stage` 'UNCONTACTED' | 'CONTACTED' | 'REPLIED': The pipeline stage (default UNCONTACTED).
  - `connectionId` string: Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one.

## Response `200`

It worked. Inside result: done, candidateId, action, hiringProjectId, from, usedToday, dailyLimit.

- Worked
  - `ok` true, required
  - `result` object, required: What was asked for. A field that does not apply is left out, or is null.

## Other responses

- `default`: It did not work. The message says why, in plain English.

---

[API](https://skmtc.dev/heyreagent/apis/heyreagent-api.md) · [All operations](https://skmtc.dev/heyreagent/apis/heyreagent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heyreagent/apis/heyreagent-api/revisions/917360c5f841?raw)