list_departments_locations
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.
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_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_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_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_offers
List job offers and/or talent pools. Filter by type (job or talent_pool) and scope (e.g., "active" for non-archived offers).
Manage the full recruitment pipeline including candidates, job offers, talent pools, and careers site content. Create, search, update, and delete candidates with profile data, CVs, and custom fields. Create and manage job offers with details like title, description, department, and status. Assign candidates to jobs or talent pools, move them through pipeline stages, disqualify or requalify them. Upload file attachments such as resumes and cover letters. Retrieve office locations and departments. Access published job listings via a public careers site API and submit candidate applications programmatically. Access audit logs to track account changes. Receive webhooks for candidate creation, assignment, pipeline changes, deletion, and job publish/unpublish/update events.
Common questions about connecting Recruitee to AI agents with Metorial.