rc.createProject

Create a private project in LinkedIn Recruiter Lite and get its ID. For example, create one project per role, then save candidates into it with rc.saveToProject.

The account needs a Recruiter Lite seat, Linked API's Plus plan and a supported LinkedIn interface language – see Recruiter Lite. To see the projects you already have, call rc.retrieveProjects.

Constraints

⏺️ Root Start: allowed.

⬆️ Parent Actions: N/A.

⬇️ Child Actions: N/A.

Parameters

{
  "actionType": "rc.createProject",
  "label": "newProject",
  "name": "Data Engineers – Amsterdam"
}

In AI assistants, the MCP tool is rc_create_project. The n8n action is Create project in Recruiter Lite; the Make module is Create Project in Recruiter Lite.

ParameterDescription
labelOptional. Label included in workflow completion.
nameRequired. Project name on a single line, from 1 to 100 characters after spaces at the start and end are removed.

The project gets only its name. Any other field, such as description, is rejected with invalidWorkflow: set the description afterwards with rc.renameProject. Job title and location cannot be set.

Creating behaviour

  • A private project. The project is created with Recruiter's Private visibility.
  • One click. The action clicks Create once and never repeats the click. It succeeds once the new project's ID shows in Recruiter's address bar.
  • Check before you call again. An error that comes back after the Create click does not prove the project was not created: the click may have landed just before a browser stall, or before LinkedIn moved the tab to its multiple-sessions notice (recruiterMultipleSessionsDetected). The project may also appear a moment later. So before you retry an rc.createProject that failed, check rc.retrieveProjects for a project with that name. The action does not check for an existing project with the same name itself, and Recruiter Lite can only archive a duplicate, not delete it.

Result options

  1. Successful creation:
json
{
  "actionType": "rc.createProject",
  "label": "newProject",
  "success": true,
  "data": {
    "projectId": "1700000003",
    "projectUrl": "https://www.linkedin.com/talent/hire/1700000003/overview",
    "name": "Data Engineers – Amsterdam"
  }
}
FieldMeaning
projectIdID of the new project, a string of digits. Pass it as projectId to the other project actions.
projectUrlThe new project's overview page in Recruiter.
nameThe name read back from the new project's title, or null if it could not be read. The project exists either way.

label is included only if specified in the action parameters.

  1. Failed creation:
json
{
  "actionType": "rc.createProject",
  "label": "newProject",
  "success": false,
  "error": {
    "type": "unexpectedError",
    "message": "Something went wrong unexpectedly. The team has been notified, we'll fix this as soon as possible."
  }
}

Possible error.type values:

  • recruiterSignInRequired, recruiterTwoStepVerificationRequired, recruiterMultipleSessionsDetected – the seat needs attention, see account errors. The project may still have been created, see Check before you call again.
  • unexpectedError – Recruiter did not confirm a new project, which may still have been created. See Check before you call again.