--- title: Sage HR API Integration on Truto slug: sagehr category: ATS canonical: "https://truto.one/integrations/detail/sagehr/" --- # Sage HR API Integration on Truto **Category:** ATS **Status:** Generally available ## Unified APIs ### Unified ATS API - **Candidates** — The candidates represent a candidate. - **Jobs** — The jobs represent a job. ## How it works 1. **Link your customer's Sage HR 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 Sage HR.** The Proxy API is a 1-to-1 mapping of the Sage HR 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 assessments from the Sage HR pipeline** — Assessment platforms can detect when a candidate reaches a specific hiring stage in Sage HR and automatically trigger a skills test, then sync results back — eliminating manual coordination between recruiters and the assessment tool. - **Trigger background checks when candidates reach offer stage** — Background check providers can pull candidate PII from Sage HR when an applicant moves to 'Offer Pending,' initiate compliance checks, and update the candidate status — keeping hiring managers informed without leaving Sage HR. - **Push AI-sourced candidates directly into Sage HR job pipelines** — AI sourcing and outbound recruiting tools can match passive candidates to open positions in Sage HR and create new candidate records in the right pipeline stage, so hiring managers see sourced profiles alongside organic applicants. - **Sync open positions to external job boards and career sites** — Recruitment marketing platforms can read active job openings from Sage HR and distribute them across external channels, while routing inbound applicants back into the correct Sage HR position pipeline. - **Initiate IT provisioning when a candidate is marked as hired** — IT and device management platforms can monitor Sage HR for hired candidates or newly created employees, then automatically provision accounts, assign hardware, and prepare onboarding workflows before the start date. ## What you can build - **Kanban stage change detection via polling** — Since Sage HR lacks native webhooks, use Truto's scheduled polling to detect when candidates move between pipeline stages and trigger downstream workflows in your product. - **One-click job board sync** — Let your users connect their Sage HR account and automatically mirror all active positions to your recruitment marketing or job distribution platform. - **Candidate profile push from external sources** — Enable your users to push sourced or externally applied candidates directly into a Sage HR position pipeline, complete with resume and contact details. - **Assessment score writeback to candidate profiles** — After a candidate completes a test or evaluation in your product, sync the score and result summary back to their Sage HR candidate record for recruiter review. - **Unified candidate and job data across multiple ATS platforms** — Use Truto's Unified ATS API to normalize Sage HR candidates and jobs alongside other ATS providers, so your product supports multiple integrations with a single implementation. - **Time-to-hire analytics from pipeline action history** — Pull candidate pipeline movement history from Sage HR to calculate stage durations and surface time-to-hire metrics inside your analytics or reporting product. ## FAQs ### How does authentication work with Sage HR? Sage HR uses API key authentication. The key is passed via the X-Auth-Token header on each request. Your end users provide their API key when connecting their Sage HR account through Truto. ### Does Sage HR support webhooks for real-time event notifications? No. Sage HR does not natively support webhooks. To detect changes like candidate stage movements, you need to poll relevant endpoints. Truto can handle scheduled polling to simulate near-real-time event detection. ### What data can I access through the Sage HR ATS integration? Through Truto's Unified ATS API, you can access Candidates (applicants with name, email, phone, resume, and pipeline stage) and Jobs (open positions and their associated applicants). Sage HR also exposes candidate pipeline action history for tracking stage transitions. ### Are Sage HR tools available out of the box on Truto? Sage HR integration tools are built on request. The Unified ATS API covers Candidates and Jobs as standardized resources. Contact Truto to request the integration, and the team will configure it for your use case. ### Can I write data back to Sage HR, or is it read-only? Sage HR's API supports both read and write operations for its recruitment module, including creating applicants and updating candidate records. Specific write capabilities through Truto depend on the tools configured for your integration — discuss your requirements when requesting the build. ### What types of companies typically connect their Sage HR accounts? Sage HR is popular with SMBs and fast-growing startups in the 10-250 employee range, particularly in the UK and Europe. It spans industries including retail, healthcare, non-profits, manufacturing, construction, and tech.