--- title: SmartRecruiters API Integration on Truto slug: smartrecruiters category: ATS canonical: "https://truto.one/integrations/detail/smartrecruiters/" --- # SmartRecruiters API Integration on Truto **Category:** ATS **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Groups** — Groups are a collection of users in the source application. In some applications, they might also be called Teams. - **Roles** — The Role object represents a role of a User. - **Users** — The User object represents a User. ### Unified ATS API - **Applications** — The applications represent an application for a job. - **Attachments** — The attachments represent an attachment for a candidate. - **Candidates** — The candidates represent a candidate. - **Jobs** — The jobs represent a job. ## How it works 1. **Link your customer's SmartRecruiters 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 SmartRecruiters.** The Proxy API is a 1-to-1 mapping of the SmartRecruiters 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 sourcing into SmartRecruiters** — AI sourcing tools can pull open Jobs from a customer's SmartRecruiters account and push matched passive candidates back as new Candidates with Applications, preserving source attribution for recruiter visibility. - **Trigger assessments when candidates reach a hiring stage** — Skills testing and assessment platforms can monitor Application status changes in SmartRecruiters to automatically send evaluations, then write results and report Attachments back to the candidate's application record. - **Pre-fill onboarding and payroll from hired candidates** — EOR, payroll, and onboarding platforms can detect when an Application moves to 'Hired' status and extract Candidate profiles, Job compensation data, and resume Attachments to eliminate manual data re-entry. - **Sync interviewer panels for scheduling automation** — Interview scheduling tools can ingest SmartRecruiters Users, Roles, and Groups to map interviewers to calendars and build multi-panel schedules tied to specific Applications and Jobs. - **Power recruitment analytics across multi-ATS customers** — Analytics and BI platforms can normalize SmartRecruiters data alongside other ATS sources using Truto's Unified ATS API to give talent leaders a single view of pipeline velocity, source effectiveness, and hiring metrics. ## What you can build - **Real-time application stage sync** — Listen for Application status updates in SmartRecruiters and trigger downstream workflows in your product the moment a candidate moves through hiring stages. - **Bi-directional candidate profile sync** — Pull Candidate data from SmartRecruiters into your app and push enriched or updated profile information back, keeping both systems in lockstep. - **Automated assessment report upload** — Upload PDF reports, scorecards, or compliance documents as Attachments directly onto a candidate's Application record so hiring managers review results without leaving SmartRecruiters. - **Job requisition ingestion engine** — Continuously sync open Jobs—including department, location, and compensation bands—into your product to power job matching, distribution, or workforce planning features. - **Interviewer and hiring team directory sync** — Import SmartRecruiters Users, Roles, and Groups via the Unified User Directory API to map hiring panels, enforce permissions, or route approvals inside your app. - **One-click candidate import with source tracking** — Let your users push sourced or screened candidates into SmartRecruiters as new Candidates with Applications, automatically tagging your product as the originating source. ## FAQs ### What authentication method does SmartRecruiters use? SmartRecruiters uses OAuth 2.0 for API authentication. Truto handles the full OAuth flow, token refresh, and credential storage so your end users can connect their accounts without your team managing auth infrastructure. ### Which Unified APIs does Truto support for SmartRecruiters? Truto maps SmartRecruiters to the Unified ATS API (Applications, Attachments, Candidates, Jobs) and the Unified User Directory API (Groups, Roles, Users). Additional tools or custom resources can be built on request. ### Does SmartRecruiters support webhooks for real-time data sync? Yes. SmartRecruiters provides extensive webhook subscriptions for events like candidate.created and application.status.updated, enabling real-time triggers without aggressive polling. ### Can I read and write custom fields on SmartRecruiters objects? SmartRecruiters supports custom fields on Candidates, Jobs, and Applications through its API. Truto can surface these via its integration layer. Contact the Truto team to discuss specific custom field mapping requirements. ### Are there rate limits on the SmartRecruiters API? Yes, SmartRecruiters enforces API rate limits that vary by endpoint and customer plan. Truto handles rate limit detection, backoff, and retry logic automatically so your integration stays resilient without manual throttling. ### What if I need an endpoint or data model that isn't covered by the current Unified APIs? Truto builds additional tools and custom resources on request. If you need access to SmartRecruiters data beyond the current Unified ATS and User Directory models—such as offer details, interview feedback, or GDPR consent fields—reach out and the team can scope it.