Recruitee

Sync Recruitee job postings, candidates, notes, and pipeline updates.

Attach a note to a specific candidate record.

Parameters

Parameter	Type	Required	Description
`candidate_id`	string	Yes	ID of the candidate to annotate.
`note`	string	Yes	Note text to attach to the candidate.

Response

{
  "note": "mock_value",
  "note_id": "mock_value",
  "status": "mock_value"
}

Create a new Recruitee candidate profile with a name, email, and optional tags.

Parameters

Parameter	Type	Required	Description
`name`	string	Yes	Full name of the candidate.
`email`	string	Yes	Primary email address for the candidate.
`tags`	array	No	Optional list of tags to attach to the candidate.

Response

{
  "candidate_id": "mock_value",
  "candidate_name": "mock_value",
  "emails": "mock_value",
  "status": "mock_value"
}

Retrieve a list of published Recruitee jobs with their identifiers and titles.

Parameters

Parameter	Type	Required	Description
`limit`	number	No	Maximum number of jobs to return (defaults to 25).

Response

{
  "jobs": [
    {}
  ],
  "status": "mock_value"
}

Search for candidates matching a phrase across profiles.

Parameters

Parameter	Type	Required	Description
`query`	string	Yes	Free-text search query for candidate profiles.
`limit`	number	No	Maximum number of candidates to return (defaults to 20).

Response

{
  "candidates": [
    {}
  ],
  "status": "mock_value"
}

Move a candidate to a new stage within the hiring pipeline.

Parameters

Parameter	Type	Required	Description
`candidate_id`	string	Yes	ID of the candidate to move.
`stage_id`	string	Yes	ID of the new stage for the candidate.

Response

{
  "candidate_id": "mock_value",
  "stage_id": "mock_value",
  "status": "mock_value"
}