# move_recruiter_candidate: Add or move a Recruiter candidate

Put one person into a hiring project's pipeline, or move them to another stage. This action can change or spend something, and it happens right away. Plan: Free and Connect.

```
POST https://api.heyreagent.com/v1/actions/move_recruiter_candidate
Authorization: Bearer YOUR_KEY
content-type: application/json

{
  "candidateId": "PASTE_RECRUITER_ID_HERE",
  "action": "add_candidate",
  "hiringProjectId": "PASTE_HIRING_PROJECT_ID_HERE"
}
```

## What you give it

- `candidateId` (needed): a Recruiter id. The person's Recruiter id (AE…). Where to get it: Run `search_linkedin_recruiter_people` and use `results[].id`.
- `action` (needed): one of: add_candidate, add_applicant, change_stage. add_candidate: add someone you sourced. add_applicant: add someone who applied. change_stage: move someone already in the pipeline.
- `hiringProjectId` (needed): a hiring project id. The hiring project (from list_hiring_projects). Where to get it: Run `list_hiring_projects` and use `projects[].id`.
- `stage` (optional): one of: UNCONTACTED, CONTACTED, REPLIED. The pipeline stage (default UNCONTACTED).
- `connectionId` (optional): a connection id. Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one. Where to get it: Run `list_linkedin_accounts` and use `accounts[].id`.

## What you get back

- `done`
- `candidateId`
- `action`
- `hiringProjectId`
- `from`: the account it ran on
- `usedToday`: number
- `dailyLimit`: number

## Good to know

- 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.

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