--- title: CATS API Integration on Truto slug: cats category: ATS canonical: "https://truto.one/integrations/detail/cats/" --- # CATS API Integration on Truto **Category:** ATS **Status:** Generally available ## Unified APIs ### Unified ATS API - **Attachments** — The attachments represent an attachment for a candidate. - **Candidates** — The candidates represent a candidate. - **Job Interview Stages** — The job interview stages represent a job interview stage. - **Jobs** — The jobs represent a job. ## How it works 1. **Link your customer's CATS 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 CATS.** The Proxy API is a 1-to-1 mapping of the CATS 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 reference and background checks triggered by pipeline stage changes** — SaaS companies offering reference checking or background screening can monitor CATS interview stages via Truto. When a candidate moves to a designated stage like 'Reference Check' or 'Background Check,' the app pulls candidate data, runs the check, and uploads the final report back to CATS as an attachment — keeping recruiters inside their ATS. - **Sync hired candidates into HRIS and onboarding platforms** — HRIS and onboarding tools can detect when a CATS candidate reaches 'Placed' or 'Hired' status, then pull the full candidate record and resume attachment to automatically provision a new employee profile. This eliminates manual copy-paste for staffing agencies and internal HR teams transitioning candidates into employees. - **Power AI sourcing tools with live job and candidate data** — AI sourcing and outreach platforms can read active job orders from CATS to understand what roles recruiters are filling, then push enriched candidate profiles and parsed resumes directly into the right job pipeline — giving recruiters instant access to sourced talent without leaving CATS. - **Distribute job postings to external career sites and job boards** — Job distribution platforms can pull active jobs from CATS — including descriptions, locations, and requirements — to programmatically syndicate postings across job boards and career portals, ensuring listings stay in sync with what recruiters are actively working on. - **Trigger assessments and skill evaluations from within the hiring pipeline** — Assessment SaaS platforms can listen for stage changes in CATS and automatically send candidates a skills test or evaluation when they reach the 'Assessment' stage. Results can be uploaded back to the candidate's profile as an attachment, giving recruiters a complete view without switching tools. ## What you can build - **Stage-based workflow automation** — Trigger actions in your product — like sending assessments, initiating background checks, or starting onboarding — whenever a candidate moves to a specific interview stage in CATS. - **One-click candidate push from sourcing tools** — Let your users push enriched candidate profiles and resume attachments directly into a CATS job pipeline from your sourcing or CRM product, eliminating manual data entry for recruiters. - **Automated report and document upload to candidate profiles** — Upload generated reports — reference checks, assessment scorecards, screening results — as attachments on the candidate's CATS profile so recruiters have everything in one place. - **Real-time job order sync for distribution and advertising** — Pull active job orders from CATS including descriptions and metadata to power programmatic job advertising, career page widgets, or multi-board distribution features in your product. - **Candidate-to-employee data bridge** — Read candidate records and their attached resumes from CATS upon hire to automatically populate employee profiles in your HRIS, payroll, or onboarding system. - **Pipeline visibility dashboard for connected CATS accounts** — Surface a read-only view of your end users' CATS jobs, candidates, and interview stages inside your product so they can take action without context-switching. ## FAQs ### What Unified API resources does Truto support for CATS? Truto maps CATS to the Unified ATS API, which includes Candidates, Jobs, Attachments, and Job Interview Stages. These cover the core hiring workflow — managing candidate profiles, tracking open requisitions, handling resumes and documents, and reading or updating pipeline stages. ### Can I read and write data to CATS through Truto, or is it read-only? The Unified ATS API supports both read and write operations for the mapped resources. For example, you can POST new candidate profiles, upload attachments, and update interview stages, in addition to reading jobs and candidate data. ### Does Truto handle authentication for CATS connections? Yes. Truto manages the full auth flow for CATS, so your end users can connect their CATS accounts through Truto's embeddable linking experience. You don't need to build or maintain the auth logic yourself. ### Are there additional CATS API endpoints available beyond the Unified ATS API? CATS-specific tools beyond the Unified ATS API resources are not pre-built but are available on request. If you need access to CATS-specific features like custom fields or specialized endpoints, Truto can build those out for your use case. ### How does Truto handle pagination and rate limits for the CATS API? Truto abstracts away CATS API pagination and rate limit handling. When you query the Unified ATS API, Truto manages page iteration and respects CATS API rate limits behind the scenes, so you get complete result sets without building retry or pagination logic. ### Can I map CATS custom candidate statuses to Truto's Job Interview Stages? Yes. CATS relies heavily on customizable candidate statuses (e.g., Screening, Interviewing, Placed). These are exposed through the Job Interview Stages resource in the Unified ATS API, allowing your product to read available stages and react to or trigger stage transitions programmatically.