# rc.saveToProject

Save a candidate to a LinkedIn Recruiter Lite project, from a Recruiter profile URL or for each candidate of a search.

> The API Reference is also the SDK and CLI reference. Consecutive code fences marked `tab=HTTP`, `tab=Node`, `tab=Python` and `tab=CLI` are the same call on each surface (a fence marked `tab=HTTP,CLI` is the same text for both), and a block between `:::surface <names>` and `:::` applies only to the surfaces it names. Identifiers in the text are written as in Node and in HTTP JSON (camelCase); the Python SDK spells methods, parameters and result attributes in snake_case (`sendMessage` → `send_message`, `reconnectionLink` → `reconnection_link`), while names inside HTTP JSON stay camelCase.

Save a candidate to one of your LinkedIn Recruiter Lite projects. The candidate is added to the project's first stage. Use it on its own with a Recruiter profile URL, or under [rc.doForPeople](/docs/action-rc-do-for-people) for each candidate of a search.

The account needs a Recruiter Lite seat, Linked API's Plus plan and a [supported LinkedIn interface language](/docs/recruiter-lite-overview#seat-requirements) – see [Recruiter Lite](/docs/recruiter-lite-overview). To find a project's ID, call [rc.retrieveProjects](/docs/action-rc-retrieve-projects).

:::surface node,python
In the SDK this is the `rcSaveToProject` method. It takes the parameters below except `label`, which exists only in workflow JSON, and returns the result below in `data`.
:::

:::surface cli
The command is `linkedin recruiter person save`. Its argument and flag are listed below.
:::

## Constraints

> ⏺️ **Root Start:** allowed, when `personUrl` parameter is provided.

> ⬆️ **Parent Actions:** [rc.doForPeople](/docs/action-rc-do-for-people).

> ⬇️ **Child Actions:** N/A.

## Parameters

```json tab=HTTP
{
  "actionType": "rc.saveToProject",
  "label": "save1",
  "personUrl": "https://www.linkedin.com/talent/profile/AEMAAB0xExampleProfileId1",
  "projectId": "1700000001"
}
```

```typescript tab=Node
const workflow = await linkedapi.rcSaveToProject.execute({
  personUrl: "https://www.linkedin.com/talent/profile/AEMAAB0xExampleProfileId1",
  projectId: "1700000001"
});

const { data, errors } = await linkedapi.rcSaveToProject.result(workflow.workflowId);
```

```python tab=Python
from linkedapi import RcSaveToProjectParams

workflow = linkedapi.rc_save_to_project.execute(
    RcSaveToProjectParams(
        person_url="https://www.linkedin.com/talent/profile/AEMAAB0xExampleProfileId1",
        project_id="1700000001",
    )
)

result = linkedapi.rc_save_to_project.result(workflow.workflow_id)
```

```bash tab=CLI
linkedin recruiter person save https://www.linkedin.com/talent/profile/AEMAAB0xExampleProfileId1 \
  --project-id 1700000001 \
  --json
```

In AI assistants, the MCP tool is `rc_save_to_project`. The n8n action is **Save to project in Recruiter Lite**; the Make module is **Save to Project in Recruiter Lite**.

| Parameter | Description |
| --- | --- |
| `label` | Optional. Label included in workflow completion. |
| `personUrl` | Required at the root, not allowed under [rc.doForPeople](/docs/action-rc-do-for-people), which supplies it. A Recruiter profile URL, `https://www.linkedin.com/talent/profile/…`, such as `recruiterProfileUrl` from [rc.searchPeople](/docs/action-rc-search-people). A public profile URL (`linkedin.com/in/…`) is rejected with `invalidWorkflow`. |
| `projectId` | Required. Project ID, a string of digits, from [rc.retrieveProjects](/docs/action-rc-retrieve-projects) or [rc.createProject](/docs/action-rc-create-project). |

:::surface cli
| Arg | Required | Description |
| --- | --- | --- |
| `url` | yes | Recruiter profile URL of the candidate, `https://www.linkedin.com/talent/profile/…` |

| Flag | Description |
| --- | --- |
| `--project-id` | Required. Project ID, from `linkedin recruiter projects` or `linkedin recruiter projects create`. |
:::

## Saving behaviour

- **Opened in the project.** The action opens the candidate's profile in the project's context, so it counts one `rcPersonProfileViews` [limit](/docs/recruiter-lite-overview#limits) view. Do not open the same candidate with [rc.openPersonPage](/docs/action-rc-open-person-page) first just to save them: that loads the profile twice and counts twice.
- **Already there.** If the candidate is already in the project, nothing is clicked and the result has `alreadyInProject` set to `true`. The action reads the project membership twice, a second apart, and acts only when both reads agree.
- **One click.** Otherwise it clicks Save once and requires Recruiter to show the candidate as saved. It never clicks a second time, so a failed call does not leave a double save.
- **Repeating is safe.** Calling again for the same candidate and project returns `alreadyInProject` set to `true`.

## Result options

1. **Successful saving:**

```json
{
  "actionType": "rc.saveToProject",
  "label": "save1",
  "success": true,
  "data": {
    "alreadyInProject": false
  }
}
```

| Field | Meaning |
| --- | --- |
| `alreadyInProject` | `true` if the candidate was already in the project and nothing was changed; `false` if this call saved them. |

`label` is included only if specified in the action parameters.

2. **Failed saving:**

```json
{
  "actionType": "rc.saveToProject",
  "label": "save1",
  "success": false,
  "error": {
    "type": "projectNotFound",
    "message": "The Recruiter project could not be opened or no longer exists."
  }
}
```

Possible `error.type` values:

- `projectNotFound` – the seat cannot open the project: Recruiter dropped it from the profile's address and showed that you may not have access to it. Nothing was clicked.
- `recruiterSignInRequired`, `recruiterTwoStepVerificationRequired`, `recruiterMultipleSessionsDetected` – the seat needs attention, see [account errors](/docs/recruiter-lite-overview#account-errors).
- `limitExceeded` – the account reached its `rcPersonProfileViews` [limit](/docs/recruiter-lite-overview#limits).
- `unexpectedError` – the candidate could not be saved, or Recruiter did not confirm the save. LinkedIn's [other warning screens](/docs/recruiter-lite-overview#other-warning-screens) end here too, so check Recruiter in the account's cloud browser before you call again. If the save went through, the new call returns `alreadyInProject` set to `true`.

Under [rc.doForPeople](/docs/action-rc-do-for-people), a failure stops the search at that candidate – see [Results and paging](/docs/action-rc-search-people#results-and-paging).
