--- title: Flatchr API Integration on Truto slug: flatchr category: ATS canonical: "https://truto.one/integrations/detail/flatchr/" --- # Flatchr API Integration on Truto **Category:** ATS **Status:** Generally available ## MCP-ready AI tools Truto exposes 28 tools for Flatchr that AI agents can call directly. - **flatchr_auth_login** — Login auth using the flatchr API. - **create_a_flatchr_vacancy** — Create vacancies using the flatchr API. - **list_all_flatchr_vacancies** — List vacancies using the flatchr API. - **flatchr_vacancies_list_active** — List active vacancies using the flatchr API. - **get_single_flatchr_vacancy_by_id** — Get vacancies using the flatchr API. - **flatchr_applicants_search** — Search applicants using the flatchr API. - **create_a_flatchr_applicant** — Create applicants using the flatchr API. - **flatchr_applicants_test** — Test applicants using the flatchr API. - **flatchr_applicants_archive** — Archive applicants using the flatchr API. - **flatchr_applicants_move** — Move applicants using the flatchr API. - **flatchr_applicants_create_custom** — Create a candidate through the public careers-site multipart form. Supports vacancy, name, comment, and question answers. - **list_all_flatchr_comments** — List comments using the flatchr API. - **delete_a_flatchr_comment_by_id** — Delete comments using the flatchr API. - **list_all_flatchr_messages** — List messages using the flatchr API. - **create_a_flatchr_task** — Create tasks using the flatchr API. - **update_a_flatchr_task_by_id** — Update tasks using the flatchr API. - **list_all_flatchr_tasks** — List tasks using the flatchr API. - **list_all_flatchr_tags** — List tags using the flatchr API. - **list_all_flatchr_candidate_tags** — List candidate tags using the flatchr API. - **create_a_flatchr_candidate_tag** — Create candidate tags using the flatchr API. - **list_all_flatchr_activities** — List activities using the flatchr API. - **list_all_flatchr_channels** — List channels using the flatchr API. - **list_all_flatchr_columns** — List columns using the flatchr API. - **list_all_flatchr_contract_types** — List contract types using the flatchr API. - **list_all_flatchr_education_levels** — List education levels using the flatchr API. - **list_all_flatchr_members** — List members using the flatchr API. - **list_all_flatchr_metiers** — List metiers using the flatchr API. - **flatchr_candidates_add_meta** — Add metadata to a candidate profile. Requires the Premium CV Library option; candidate reference is an email address. ## How it works 1. **Link your customer's Flatchr 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 Flatchr.** The Proxy API is a 1-to-1 mapping of the Flatchr 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 - **Embed AI interviewing and assessments inside Flatchr pipelines** — Assessment and video interview platforms can let their users plug directly into Flatchr's hiring stages — detecting when candidates reach a specific column, triggering assessments, and writing results back as tags or metadata without the user leaving Flatchr. - **Automate background checks and compliance verification** — Background check providers can offer their customers a native Flatchr integration that watches for candidates entering a verification stage, pulls applicant data to initiate checks, and posts status back via tags and recruiter tasks — no manual CSV uploads. - **Power custom career sites and franchise sourcing portals** — SaaS companies building branded career pages or multi-site sourcing tools can sync active vacancies, contract types, education levels, and job categories from Flatchr, then push applicants and resumes back in so local managers see candidates instantly. - **Hand off hired candidates to HRIS and onboarding tools** — Onboarding and HRIS platforms can monitor Flatchr for candidates moved into the final hiring stage and automatically kick off employee provisioning — eliminating the double entry recruiters hate. - **Enrich candidate profiles from sourcing and CRM tools** — Sourcing CRMs and talent intelligence tools can push enriched candidates, tags, and custom metadata into Flatchr so recruiters get a richer profile without leaving their ATS. ## What you can build - **Stage-triggered workflow automation** — Listen for candidates entering specific Flatchr columns and trigger assessments, outreach, or compliance workflows in your product. - **Two-way candidate sync with resume upload** — Create applicants in Flatchr with multipart resume files, custom question answers, and vacancy matching using the applicant creation endpoints. - **Vacancy mirror for external career pages** — Keep an always-fresh copy of active Flatchr vacancies — complete with contract types, education levels, and métiers — rendered on your customers' career sites. - **Candidate enrichment via tags and metadata** — Write assessment scores, screening outcomes, or verification status back to Flatchr profiles using candidate tags and meta fields. - **Pipeline progression control** — Programmatically move candidates between Flatchr columns when upstream workflows complete, so recruiters always see the right people in the right stage. - **Recruiter task delegation** — Create and update tasks inside Flatchr to assign action items — like 'Review background check report' — to the right recruiter at the right moment. ## FAQs ### How do end users authenticate their Flatchr account? Truto handles the Flatchr auth flow via the flatchr_auth_login connector. Your users complete the connection through Truto's hosted link or embedded flow, and Truto manages token storage and refresh so you never touch credentials directly. ### Can we upload resumes and candidate files to Flatchr? Yes. The flatchr_applicants_create_custom endpoint supports multipart form submissions, so you can push resume files along with applicant names, vacancy references, and custom question responses in a single call. ### How do we keep vacancy data in sync? Use list_all_flatchr_vacancies or flatchr_vacancies_list_active for polling, and get_single_flatchr_vacancy_by_id for individual lookups. Combine with list_all_flatchr_contract_types, list_all_flatchr_education_levels, and list_all_flatchr_metiers to resolve reference data for display. ### How do we map our workflows to Flatchr's hiring stages? Call list_all_flatchr_columns to fetch each account's pipeline stages, let your users map their workflow triggers to specific columns, then use flatchr_applicants_move to progress candidates when upstream actions complete. ### Can we attach custom data like assessment scores to a candidate? Yes. Use create_a_flatchr_candidate_tag to label profiles (e.g., 'Assessment: Passed') and flatchr_candidates_add_meta to append structured metadata. Note that add_meta is available for premium CV library users on Flatchr's side. ### Can we assign follow-up tasks to recruiters inside Flatchr? Yes. create_a_flatchr_task lets your product delegate action items to recruiters directly in Flatchr, and update_a_flatchr_task_by_id lets you update their status as your workflow progresses. ## Related reading - [Connect Flatchr to ChatGPT: Manage Vacancies and Applicant Workflow](https://truto.one/blog/connect-flatchr-to-chatgpt-manage-vacancies-and-applicant-workflow/) — Learn how to connect Flatchr to ChatGPT using Truto's managed MCP server. This guide covers setup, tool execution, and complex ATS workflow automation. - [Connect Flatchr to Claude: Sync Recruitment Tasks and Candidate Data](https://truto.one/blog/connect-flatchr-to-claude-sync-recruitment-tasks-and-candidate-data/) — Learn how to build a managed MCP server for Flatchr. Give Claude secure read and write access to candidates, vacancies, and recruitment pipelines without maintaining integration code. - [Connect Flatchr to AI Agents: Automate Hiring and Pipeline Operations](https://truto.one/blog/connect-flatchr-to-ai-agents-automate-hiring-and-pipeline-operations/) — Learn how to connect Flatchr to AI agents using Truto's /tools endpoint. Fetch Flatchr tools, bind them to your LLM, and build autonomous hiring workflows.