--- title: Fountain API Integration on Truto slug: fountain category: ATS canonical: "https://truto.one/integrations/detail/fountain/" --- # Fountain API Integration on Truto **Category:** ATS **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Users** — The User object represents a User. ### 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. - **Interviews** — The interviews represent an interview. - **Job Interview Stages** — The job interview stages represent a job interview stage. - **Jobs** — The jobs represent a job. - **Users** — The users represent a user. ## How it works 1. **Link your customer's Fountain 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 Fountain.** The Proxy API is a 1-to-1 mapping of the Fountain 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 background screening for high-volume hourly hiring** — Background check providers can detect when a Fountain candidate reaches a specific hiring stage, pull candidate data, run checks, and push results back as attachments and activity notes — all without manual intervention from recruiters managing thousands of applicants. - **Sync newly hired frontline workers into workforce management tools** — Shift scheduling and workforce management SaaS platforms can continuously sync candidates who reach the 'Hired' stage in Fountain, along with their associated job and location data, to automatically provision employee accounts and populate shift rosters. - **Push applicants from job boards directly into Fountain funnels** — Niche job boards and gig-worker talent marketplaces can offer seamless apply experiences by creating candidates in their clients' Fountain environments, attaching profile documents, and mapping applicants to specific job requisitions. - **Enrich hiring funnels with AI-driven candidate screening** — Conversational AI and pre-screening SaaS products can read new candidate data from Fountain, conduct automated assessments, and write screening results back as activity notes and candidate updates to keep recruiters' workflows uninterrupted. - **Bridge Fountain hiring data into HRIS and payroll systems** — Onboarding and payroll platforms can extract hired candidates, hiring manager details, and signed documents from Fountain to instantly create employee records — eliminating the manual data entry that slows down high-volume onboarding. ## What you can build - **Automated candidate stage progression** — Move candidates across Fountain's job interview stages programmatically based on external triggers like completed background checks, assessment scores, or document verifications. - **Real-time hired-candidate sync** — Continuously pull candidates who reach the 'Hired' stage along with their associated job and location data to auto-provision them in downstream systems like payroll or scheduling tools. - **Document and attachment ingestion** — Push compliance documents, identity verification files, or screening result PDFs directly to candidate profiles in Fountain as attachments. - **Activity-based audit trail** — Write structured activity notes to candidate profiles in Fountain to create a full audit trail of external actions — screening results, AI chat transcripts, or assessment summaries. - **Job-to-location mapping for multi-site hiring** — Read Fountain jobs and their associated metadata to map candidates to specific store locations, enabling location-aware workflows in your product. - **Unified candidate and user directory** — Pull candidate records alongside Fountain user data (recruiters, hiring managers) through a single normalized schema to power reporting dashboards or permissioned workflows. ## FAQs ### What Unified APIs does Truto support for Fountain? Truto supports the Unified ATS API (Activities, Attachments, Candidates, Interviews, Job Interview Stages, Jobs, Users) and the Unified User Directory API (Users) for Fountain. Specific tools are built on request based on your integration needs. ### Are there pre-built Truto tools available for Fountain? Fountain currently has no pre-built tools in Truto's catalog. Tools are built on request — reach out with your specific use case and Truto will scope and deliver the integration resources you need. ### How does Truto handle Fountain's high-volume data without hitting rate limits? Truto manages pagination and request throttling automatically, abstracting away Fountain's API-specific rate limit behavior. For high-volume hiring scenarios, leveraging webhooks for candidate status changes is strongly recommended over polling to avoid unnecessary API calls. ### Can I read and write custom fields and tags on Fountain candidates? Custom fields and tags are critical to Fountain's routing and automation logic. Support for reading and writing these fields can be scoped when Truto builds your Fountain tools — specify which custom fields matter for your workflow during onboarding. ### How does authentication work for Fountain integrations via Truto? Truto handles the authentication flow with Fountain on behalf of your end users. Your customers connect their Fountain accounts through Truto's embedded linking experience, and Truto manages token storage and refresh so you never deal with auth plumbing directly. ### Can I programmatically move candidates between stages in Fountain? Yes — the Unified ATS API exposes Job Interview Stages and Candidates, which together enable stage progression workflows. This is one of the most common patterns for Fountain integrations, powering use cases like automated background check initiation and AI screening approvals.