--- title: Taleez API Integration on Truto slug: taleez category: ATS canonical: "https://truto.one/integrations/detail/taleez/" --- # Taleez API Integration on Truto **Category:** ATS **Status:** Generally available ## MCP-ready AI tools Truto exposes 35 tools for Taleez that AI agents can call directly. - **create_a_taleez_spontaneous_application** — Create spontaneous applications using the taleez API. - **list_all_taleez_pool_candidates** — List pool candidates using the taleez API. - **create_a_taleez_pool_candidate** — Create pool candidates using the taleez API. - **create_a_taleez_job_candidate** — Create job candidates using the taleez API. - **create_a_taleez_job_application** — Create job applications using the taleez API. - **list_all_taleez_candidate_properties** — List candidate properties using the taleez API. - **get_single_taleez_candidate_property_by_id** — Get candidate properties using the taleez API. - **list_all_taleez_candidate_pools** — List candidate pools using the taleez API. - **create_a_taleez_candidate_pool** — Create candidate pools using the taleez API. - **create_a_taleez_candidate_job** — Create candidate jobs using the taleez API. - **list_all_taleez_candidate_documents** — List candidate documents using the taleez API. - **create_a_taleez_candidate_document** — Create candidate documents using the taleez API. - **list_all_taleez_spontaneous_questions** — List spontaneous questions using the taleez API. - **list_all_taleez_job_steps** — List job steps using the taleez API. - **list_all_taleez_job_statuses** — List job statuses using the taleez API. - **list_all_taleez_job_questions** — List job questions using the taleez API. - **list_all_taleez_jobs_filters** — List jobs filters using the taleez API. - **list_all_taleez_candidate_applications** — List candidate applications using the taleez API. - **list_all_taleez_candidate_property_values** — List candidate property values using the taleez API. - **update_a_taleez_candidate_property_value_by_id** — Update candidate property values using the taleez API. - **create_a_taleez_candidate** — Create candidates using the taleez API. - **get_single_taleez_candidate_by_id** — Get candidates using the taleez API. - **list_all_taleez_candidates** — List candidates using the taleez API. - **update_a_taleez_candidate_by_id** — Update candidates using the taleez API. - **create_a_taleez_document** — Create documents using the taleez API. - **list_all_taleez_events** — List events using the taleez API. - **get_single_taleez_job_property_by_id** — Get job properties using the taleez API. - **list_all_taleez_job_properties** — List job properties using the taleez API. - **get_single_taleez_job_by_id** — Get jobs using the taleez API. - **list_all_taleez_jobs** — List jobs using the taleez API. - **list_all_taleez_pools** — List pools using the taleez API. - **list_all_taleez_recruiters** — List recruiters using the taleez API. - **list_all_taleez_units** — List units using the taleez API. - **list_all_taleez_candidate_events** — List candidate events using the taleez API. - **create_a_taleez_tmp_document** — Create tmp documents using the taleez API. ## How it works 1. **Link your customer's Taleez 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 Taleez.** The Proxy API is a 1-to-1 mapping of the Taleez 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 - **Push sourced candidates into Taleez pipelines** — Sourcing and recruitment marketing platforms can let users export passive candidates directly to Taleez talent pools or active job openings, eliminating manual CSV uploads and keeping the ATS as the single source of truth. - **Trigger assessments on pipeline stage changes** — Pre-employment testing and video interviewing tools can detect when a candidate reaches a specific job step in Taleez, auto-send their assessment, and write results back as custom property values and attached PDF reports. - **Provision new hires into HRIS and onboarding tools** — HRIS and onboarding platforms can pull the complete candidate profile, custom field values, and documents from Taleez the moment someone is marked as hired, instantly creating an employee record without duplicate data entry. - **Syndicate Taleez jobs to external career channels** — Programmatic job advertising and career site builders can pull live job listings, properties, and required application questions from Taleez to publish openings and route applicants back as structured candidates. - **Enrich candidate profiles with third-party data** — Background check, culture-fit scoring, and reference check tools can tag Taleez candidates with their results by updating custom candidate properties, surfacing enriched data directly in the recruiter's workflow. ## What you can build - **One-click candidate export to Taleez** — Let users push a candidate with resume, contact details, and metadata into a specific Taleez job or talent pool in a single action. - **Pipeline stage webhooks for downstream automation** — Poll candidate applications, job steps, and job statuses to trigger assessments, background checks, or notifications the moment a recruiter advances a candidate. - **Resume and report upload to candidate files** — Attach parsed CVs, assessment PDFs, interview transcripts, or portfolio documents directly to the Taleez candidate record so recruiters see everything in one place. - **Custom property write-back for scores and tags** — Discover a customer's custom candidate properties and write third-party scores, labels, or enrichment data back into them so results appear natively on the Taleez dashboard. - **Hired-candidate sync to HRIS** — Detect status changes, fetch the full candidate profile with custom field values and documents, and provision a new employee record automatically on hire. - **External career site powered by Taleez jobs** — Pull active jobs, job properties, and application questions to render fully branded career pages or job widgets that stay in sync with Taleez. ## FAQs ### How do end users connect their Taleez account through our product? Truto handles the full auth flow for Taleez via its connected accounts system, so your users authenticate once and Truto manages token storage and refresh. You call the Taleez tools through Truto using the connected account ID — no need to build or maintain the auth layer yourself. ### Can we react to pipeline stage changes in real time? Taleez's API supports polling candidate applications, job steps, and job statuses to detect stage transitions. You can set up scheduled polling through Truto to approximate real-time triggers for downstream actions like sending assessments or background checks. ### Does the integration support custom candidate fields? Yes. You can list candidate properties, read their current values per candidate, and update specific property values by ID — so you can both read customer-defined custom fields and write third-party data back into them. ### Can we upload resumes and assessment reports to a candidate's file? Yes. The integration supports creating candidate documents and temporary documents, so you can attach PDFs like parsed resumes, scorecards, or interview recordings directly to the Taleez candidate record. ### What candidate ingestion options are available? You can create standalone candidates, add them to a specific job as a candidate or application, push them into a talent pool, or submit spontaneous applications. This covers both active-opening and passive-sourcing workflows. ### Can we pull job and application question metadata to build external career pages? Yes. You can list all jobs, fetch individual job details, retrieve job properties, and list the job questions required for an application — giving you everything needed to render external listings and submit structured applications back to Taleez. ## Related reading - [Connect Taleez to ChatGPT: Manage recruitment and candidates via MCP](https://truto.one/blog/connect-taleez-to-chatgpt-manage-recruitment-and-candidates/) — Learn how to connect Taleez to ChatGPT using Truto's MCP server. A complete engineering guide to automating candidate sourcing, job applications, and ATS pipelines. - [Connect Taleez to Claude: Streamline Hiring and Applications](https://truto.one/blog/connect-taleez-to-claude-streamline-hiring-and-applications/) — Learn how to connect Taleez to Claude using Truto's managed MCP server. Automate recruitment, manage candidate pipelines, and update ATS data using natural language. - [Connect Taleez to AI Agents: Automate Candidate Workflows](https://truto.one/blog/connect-taleez-to-ai-agents-automate-candidate-workflows/) — A step-by-step guide to connecting Taleez to AI Agents. Learn how to fetch tools via Truto's API, bind them to LLMs, and automate candidate workflows.