Recruitee

Recruitee

This connector reads and updates Recruitee (Tellent Recruitee), an applicant tracking system, through its ATS API (https://api.recruitee.com/c/<company id>): jobs and talent pools, candidates, pipelines and stages, notes, tags, departments, locations, interviews and evaluations, tasks and the activity feed.

Personal data: candidates are applicants with CVs, contact details, evaluations and sometimes date of birth or nationality. Read only what the task needs and respect the company's GDPR settings; do not copy candidate data into other tools without a reason.

Setup (3 minutes)

1. In Recruitee open Settings > Apps and plugins > Personal API tokens (https://app.recruitee.com/#/settings/api_tokens), click Add new token, give it a label and confirm your password. Copy the token into RECRUITEE_API_TOKEN.
2. Copy the company ID shown on the same page into RECRUITEE_COMPANY_ID.
3. The token acts as you, with your role, in that one company only (another company needs its own token). Recruitee cannot narrow its scope, so create it with a user whose role fits what the agent should do. recruitee_get_current_admin is the install check.

Words: a job is an offer (kind job; a talent pool is an offer of kind talent_pool). A candidate in a job is a placement: it carries the stage and the disqualification for that job. Team members are admins.

Workflow

• Team: recruitee_get_current_admin, recruitee_list_admins (ids for task assignees and filters).
• Jobs: recruitee_list_offers (filter by statuses such as published), recruitee_get_offer (description and the pipeline stages with their ids), recruitee_list_offer_notes. Create and manage: recruitee_create_offer (draft), recruitee_update_offer, recruitee_publish_offer, recruitee_unpublish_offer, recruitee_close_offer.
• Candidates: recruitee_list_candidates (simple filters), recruitee_search_candidates (full search with filters_json), recruitee_get_candidate (profile and placements), recruitee_list_candidate_notes, recruitee_list_candidate_tasks, recruitee_list_candidate_activities. Company-wide feed: recruitee_list_activities.
• Pipeline of a job: recruitee_list_placements (who is in which stage), recruitee_list_pipeline_templates, recruitee_get_pipeline_template, recruitee_list_disqualify_reasons.
• Moving candidates: recruitee_assign_candidate (into a job or talent pool), recruitee_change_stage (placement id and stage id from recruitee_get_offer), recruitee_disqualify_candidate and recruitee_requalify_candidate.
• Adding and enriching candidates: recruitee_create_candidate (optionally applied to jobs; a remote_cv_url is parsed), recruitee_update_candidate, recruitee_add_candidate_tags, recruitee_remove_candidate_tags, recruitee_add_candidate_field, recruitee_create_candidate_note.
• Reference lists: recruitee_list_departments, recruitee_get_department, recruitee_list_locations, recruitee_get_location, recruitee_list_tags, recruitee_list_sources.
• Interviews: recruitee_list_interview_events (upcoming by default), recruitee_get_interview_event, recruitee_list_interview_results (evaluations and scorecards).
• Tasks: recruitee_list_tasks, recruitee_create_task, recruitee_complete_task.

Switched off at install: recruitee_delete_candidate and recruitee_remove_placement; they cannot be undone, so an admin switches them on when the team needs them.

Automations: creating a candidate on a job, changing a stage with run_actions true, or disqualifying can trigger emails and actions the company configured in Recruitee. Say so before doing it for many candidates.

Search filters (recruitee_search_candidates): filters_json is a JSON array as a string, e.g. [{"field":"all","query":"java"},{"filter":"tags","id":{"in":[12]}},{"field":"created_at","gte":"2026-10-01"}]. Text: field all; status and source: {"field":"status","in":["qualified"]}; stages: {"filter":"stages","name":{"in":[...]}}.

Reading the answers

• Ids are integers. Dates and times are ISO 8601 in UTC (2026-10-19T11:02:32Z).
• A candidate's placements list one entry per job with offer_id, stage_id and disqualify_reason; use the placement id for stage and qualification changes.
• adminapp_url links to the candidate in Recruitee.

Paging: recruitee_list_candidates pages with limit (max 1000) and offset; offers, search, locations, activities, events and tasks page with limit and page (from 1). Stop when a page returns fewer items than limit.

Errors: 401 invalid_token means a wrong, revoked or other company's token; 403 a role without the right; 404 a wrong company ID or record id; 422 a validation error with the field named in the body.