View as Markdown
Recruiterflow icon

Recruiterflow ACTION

Move Candidate to Stage

Moves a candidate to a different stage in the job pipeline. You can specify either stage ID or stage name. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Recruiterflow account once, then configure and run Move Candidate to Stage from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "recruiterflow-move-candidate-to-stage",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    recruiterflow: { authProvisionId: "apn_xxxxxxx" },
    candidateId: "Candidate ID",
    stageId: 10,
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Move Candidate to Stage inputs
Property Type Description
candidateId Candidate ID string
The ID of the candidate to move
Required Dynamic
stageId Stage ID integer
The ID of the destination stage. Use this OR Stage Name (not both).
Optional
stageName Stage Name string
The name of the destination stage (e.g., 'Applied', 'Screening', 'Interview', 'Offer', 'Hired'). Use this OR Stage ID (not both). If using stage name, Job ID is required.
Optional
jobId Job ID string
The ID of the job. Required only when using Stage Name instead of Stage ID.
Optional Dynamic
userId User ID string
The ID of the user moving the candidate
Required Dynamic
addedTime Added Time string
Timestamp for backdating when the candidate was moved to the stage (ISO 8601 format, e.g., '2021-01-12T10:16:16+0000')
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
recruiterflow-move-candidate-to-stage
Version
0.0.2
App
Recruiterflow
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes