--- title: Breezy API Integration on Truto slug: breezy category: ATS canonical: "https://truto.one/integrations/detail/breezy/" --- # Breezy 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. - **Job Form Fields** — The form fields used to apply to a job. - **Jobs** — The jobs represent a job. - **Organizations** — The organizations represent the organization. - **Scorecards** — The scorecards represent a scorecard. ## How it works 1. **Link your customer's Breezy 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 Breezy.** The Proxy API is a 1-to-1 mapping of the Breezy 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 new hire data transfer from Breezy to your HRIS or onboarding platform** — HRIS and onboarding SaaS companies can sync candidates who reach the 'Hired' stage in Breezy, pulling their profile data and resume attachments to auto-generate employee records — eliminating manual re-entry for HR teams. - **Trigger assessments or background checks based on candidate stage changes** — Assessment and screening SaaS products can read candidate and job data from Breezy to initiate workflows when candidates move to specific pipeline stages, then write results back as scorecards, activities, or attachments so hiring managers never leave Breezy. - **Push sourced candidates directly into Breezy pipelines** — Sourcing and outbound recruiting platforms can let recruiters select an active Breezy job and create new candidate profiles with attached resumes, injecting passive candidates straight into the Kanban board without switching tools. - **Aggregate hiring data for analytics and reporting dashboards** — BI and people analytics SaaS companies can read jobs, candidates, scorecards, and activities from Breezy to power time-to-hire metrics, pipeline conversion reports, and diversity analytics across their customers' hiring workflows. ## What you can build - **Hired-stage candidate sync** — Automatically pull candidate details and resume attachments from Breezy when a candidate is moved to the Hired stage, creating a draft employee profile in your platform. - **Active job picker for candidate injection** — Fetch active jobs and organizations from Breezy to populate a dropdown in your UI, letting users select which pipeline to push new candidates into. - **Interview feedback and score writeback** — Post assessment scores, AI screening summaries, or interview feedback directly to a candidate's Breezy profile using the Scorecards and Activities APIs. - **Resume and document attachment sync** — Download candidate resumes and portfolios from Breezy or upload background check certificates, offer letters, and report PDFs back to the candidate record. - **Custom screening question ingestion** — Read Job Form Fields from Breezy so your external career page or job distribution platform can render mandatory screening questions and submit compliant applications. - **Cross-ATS hiring pipeline dashboard** — Read jobs, candidates, and scorecards from Breezy alongside other ATS platforms through Truto's Unified ATS API to build a consolidated recruiting analytics view. ## FAQs ### What authentication method does Breezy use, and how does Truto handle it? ### Which Breezy data objects are available through Truto's Unified ATS API? Truto's Unified ATS API covers Candidates, Jobs, Organizations, Attachments, Activities, Scorecards, and Job Form Fields for Breezy. These map to the core objects needed for reading candidate pipelines, writing feedback, and syncing documents. ### Can I both read and write data to Breezy through Truto? Yes. The Unified ATS API supports read operations (listing jobs, candidates, attachments, scorecards) and write operations (creating candidates, posting activities and scorecards, uploading attachments). Specific supported methods depend on the resource — refer to Truto's API reference for the exact CRUD operations available per object. ### Does Truto handle pagination and rate limits for the Breezy API? Yes. Truto abstracts away Breezy's pagination logic and manages rate limiting so you can fetch large candidate or job lists without writing custom retry or cursor-handling code. ### Are custom Breezy tools available if I need something beyond the Unified ATS API? Breezy does not have pre-built custom tools in Truto today, but they can be built on request. If you need a Breezy-specific endpoint or workflow that the Unified ATS API doesn't cover, Truto can scope and deliver it. ### How do I access custom screening questions configured on a Breezy job? Use the Job Form Fields resource in Truto's Unified ATS API. This returns the custom screening questions tied to a specific job, so your application can render them to candidates and submit compliant responses.