Built by Metorial, the integration platform for agentic AI.
Retrieve all departments and office locations configured in the Recruitee account. Useful for finding department and location IDs when creating or updating job offers.
Retrieve full details of a single candidate by ID, including their profile, placements (job assignments and pipeline stages), tags, sources, and custom fields.
Assign a candidate to an offer or talent pool, change an existing placement stage, disqualify or requalify it, or remove the assignment. Removing a placement does not erase the candidate or its history.
Delete a candidate and return its confirmed deletion timestamp. Deleted records may remain in provider history or be retrievable; this does not guarantee erasure of associated data.
Search one page of candidates. Basic query searches names and offer titles; filters selects the documented advanced search with JSON filter objects.
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 a new candidate in Recruitee. Optionally assign the candidate to job offers during creation. Use Manage Pipeline for an explicit talent-pool assignment. Manual candidate creation does not send an application confirmation email. Supports setting contact details, social links, cover letter, and a remote CV URL.
Create profile fields on a candidate profile. This endpoint creates one field per request; it does not find and overwrite an existing field. 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": "..."}]`
Retrieve all configured disqualification reasons. Use these reason IDs when disqualifying candidates through the Manage Pipeline tool.
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 default to draft. A requested status uses a separate transition followed by a readback; a failed transition can leave the created offer in its actual earlier status. Publishing exposes it on the careers site.
List, create a team-visible note, or delete an exact note from a candidate. Deletion verifies the note belongs to that candidate and is absent from the subsequent list.
Retrieve full details of a job offer or talent pool by ID, including description, requirements, locations, department, tags, status, and pipeline stages.
List company tags, add named tags to a candidate, or remove explicit tag names. Candidate changes are checked by reading the current profile.
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 one page of job offers and talent pools, with current status and ID filters. Request subsequent pages to list the complete account.
Prepare the candidate’s current CV, uploaded cover letter, or an exact candidate file for download. Requires an existing file and permission to read that candidate. A cover-letter text field is not a downloadable file.
Read the authenticated token owner and exact company binding from the company-scoped ATS API. Personal tokens inherit the creator’s company permissions.
Delete an exact job offer or talent pool, then verify that its detail endpoint reports it absent. This does not guarantee erasure of candidate profiles, retained history, or audit records.