Tools

List Departments & Locations

Retrieve all departments and office locations configured in the Recruitee account. Useful for finding department and location IDs when creating or updating job offers.

Get Candidate

Retrieve full details of a single candidate by ID, including their profile, placements (job assignments and pipeline stages), tags, sources, and custom fields.

Manage Pipeline

Move a candidate through the recruitment pipeline, disqualify them, or remove them from a job/talent pool. Use the placement ID to identify the candidate's assignment to a specific job. To find placement IDs, use the **Get Candidate** tool which returns placements for each job the candidate is assigned to.

Delete Candidate

Permanently delete a candidate from Recruitee. This removes the candidate and all associated data including placements, notes, and attachments.

Search Candidates

Search and filter candidates using Recruitee's advanced search. Supports filtering by name, email, stage, status, tags, and more. Use **query** for simple text search (name/offer), or **filters** for structured filtering with field/value pairs. Available filter fields include: `stages`, `status` (qualified/disqualified), `tags`, `sources`, `departments`, `offers`, among others.

Update Candidate

Update an existing candidate's profile information. Supports updating name, emails, phones, social links, cover letter, and CV. You can also update the CV separately via a remote URL.

Create Candidate

Create a new candidate in Recruitee. Optionally assign the candidate to one or more job offers or talent pools during creation. Supports setting contact details, social links, cover letter, and a remote CV URL.

Set Candidate Custom Fields

Set custom field values on a candidate profile. Supports various field types including text, boolean, date, skills, salary, experience, education, and more. Supported **kind** values and their **values** format: - `single_line` / `multi_line`: `[{"text": "value"}]` - `boolean`: `[{"flag": true}]` - `skills`: `[{"text": "SQL"}, {"text": "Python"}]` - `salary`: `[{"amount": "5000", "currency": "EUR"}]` - `date` / `date_of_birth`: `[{"date": "2024-01-15"}]` - `gender`: `[{"value": "female"}]` - `nationality`: `[{"country_code": "NL"}]` - `language_skill`: `[{"language_code": "en", "level": "advanced"}]` - `experience`: `[{"title": "...", "company": "...", "startDate": "...", "endDate": "..."}]` - `education`: `[{"school": "...", "degree": "..."}]`

List Disqualify Reasons

Retrieve all configured disqualification reasons. Use these reason IDs when disqualifying candidates through the Manage Pipeline tool.

Create Job Offer

Create a new job offer or talent pool in Recruitee. Set the **kind** to "talent_pool" to create a talent pool instead of a job. New offers are created as drafts by default — set the **status** to "published" to make them immediately visible on the careers site.

Manage Candidate Notes

List, create, or delete notes on a candidate profile. Notes are used for internal comments, interview feedback, and collaboration between team members.

Get Job Offer

Retrieve full details of a job offer or talent pool by ID, including description, requirements, locations, department, tags, status, and pipeline stages.

Manage Candidate Tags

Add tags to a candidate or list all available tags in the company account. Tags help organize and categorize candidates for easier filtering and searching.

Update Job Offer

Update an existing job offer or talent pool. Change its title, description, requirements, locations, department, remote status, or publication status. Use the **status** field to publish, unpublish, close, or archive an offer.

List Job Offers

List job offers and/or talent pools. Filter by type (job or talent_pool) and scope (e.g., "active" for non-archived offers).