--- title: Recruitee API Integration on Truto slug: recruitee category: ATS canonical: "https://truto.one/integrations/detail/recruitee/" --- # Recruitee API Integration on Truto **Category:** ATS **Status:** Generally available ## Unified APIs ### Unified ATS API - **Activities** — The activity on a candidate performed by a user. - **Attachments** — The attachments represent an attachment for a candidate. - **Candidates** — The candidates represent a candidate. - **Departments** — The departments represent a department. - **Jobs** — The jobs represent a job. - **Tags** — The tags represent a tag for a candidate. - **Users** — The users represent a user. ## MCP-ready AI tools Truto exposes 5 tools for Recruitee that AI agents can call directly. - **list_all_recruitee_interview_results** — List interview results in Recruitee. Requires company_id. Returns id, candidate_id, admin_id, kind, and evaluation details for each interview result. - **list_all_recruitee_notes** — Get notes for a specific candidate in Recruitee. Requires company_id and id. Returns an array of notes containing fields such as admin_id, body, created_at, attachments, and visibility. - **list_all_recruitee_locations** — List locations in Recruitee for company_id. Returns locations with fields such as id (unique location ID), name, country_code, state_name/state_code, city, full_address, created_at, updated_at, archived_at, lang_code, and optionally translations plus active_offers_count, active_requisitions_count, and is_deletable. - **list_all_recruitee_offer_notes** — List notes for an offer in Recruitee. Requires company_id and offer_id. Returns each note with id, text, admin_id, created_at, updated_at, and nested replies including visibility and reactions data. - **list_all_recruitee_admins** — List admins in Recruitee. Requires company_id. Returns admin details including id, name, email, and role. ## How it works 1. **Link your customer's Recruitee account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Recruitee.** The Proxy API is a 1-to-1 mapping of the Recruitee API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Automate candidate handoff from ATS to onboarding** — HRIS and onboarding platforms can sync hired candidates, their job details, department assignments, and attachments from Recruitee the moment a hire is made — eliminating manual data re-entry for HR teams. - **Push assessment results back into the hiring pipeline** — Skills assessment and background check platforms can pull candidate and job data from Recruitee, trigger evaluations, and write results back as tags or notes so hiring managers never leave their ATS to review scores. - **Power AI sourcing with live job and department data** — AI sourcing tools can read active jobs, departments, and user assignments from Recruitee to understand open headcount, then create matched candidates with attached resumes directly in the pipeline. - **Build headcount planning dashboards from ATS data** — Workforce planning and finance tools can sync jobs, departments, locations, and admin assignments from Recruitee to visualize where hiring is happening and forecast when new payroll costs will land. - **Centralize interview feedback for hiring analytics** — People analytics platforms can pull structured interview results, candidate notes, and offer notes from Recruitee to surface interviewer sentiment, scoring patterns, and pipeline bottlenecks. ## What you can build - **Real-time candidate and job sync** — Keep your product's candidate and job records in lockstep with Recruitee using the Unified ATS API for Candidates, Jobs, and Departments. - **Interview evaluation data export** — Pull detailed interview results including evaluation types, scores, and associated admin IDs to power hiring quality dashboards and interviewer calibration reports. - **Automated resume and document attachment** — Push signed contracts, assessment reports, or sourced resumes into Recruitee as candidate attachments via the Unified ATS Attachments resource. - **Location-aware hiring maps** — Read structured location data — country codes, state codes, and formatted addresses — from Recruitee to visualize global hiring activity and map open requisitions by region. - **Candidate tagging from external workflows** — Write tags like 'Assessment: Pass' or 'Background Check: Clear' back to Recruitee candidates so recruiters see third-party results without leaving their ATS. - **Recruiter and hiring manager assignment sync** — Use admin and user data from Recruitee to map hiring managers in your product, route tasks correctly, and mirror role-based access controls. ## FAQs ### What authentication method does the Recruitee integration use? Recruitee uses API token-based authentication. End users generate a personal API token from their Recruitee account settings and provide it during the connection flow in Truto. Truto manages token storage and request signing. ### Which data models are available through the Unified ATS API for Recruitee? The Unified ATS API exposes Activities, Attachments, Candidates, Departments, Jobs, Tags, and Users. These cover the core recruitment pipeline objects and are normalized across all ATS integrations Truto supports. ### What Recruitee-specific data can I access beyond the Unified API? Truto provides native Recruitee tools for interview results, candidate notes, offer notes, locations, and admins. These give you access to granular evaluation data, internal communication with visibility settings, structured location details, and admin role mappings. ### Does Truto handle pagination and rate limits for the Recruitee API? Yes. Truto automatically handles pagination across all list endpoints and respects Recruitee's rate limits, including retry logic with backoff. You receive clean, complete result sets without managing cursor or offset logic yourself. ### Can I write data back to Recruitee or is it read-only? The Unified ATS API supports both read and write operations for supported resources like Candidates, Tags, and Attachments. This enables bi-directional workflows such as creating candidates from external sourcing tools or pushing assessment results back as tags. ### How fresh is the data when reading from Recruitee through Truto? Truto makes real-time API calls to Recruitee by default, so data freshness matches what the Recruitee API returns at the time of the request. For high-frequency sync scenarios, you can configure polling intervals to balance freshness against rate limit consumption.