--- title: Manatal API Integration on Truto slug: manatal category: Default canonical: "https://truto.one/integrations/detail/manatal/" --- # Manatal API Integration on Truto **Category:** Default **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Activities** — Activities are the actions performed by users in the source application. - **Organizations** — Organizations are the top level entity in the source application. Users are associated with an organization. - **Users** — The User object represents a User. ### Unified ATS API - **Users** — The users represent a user. ## MCP-ready AI tools Truto exposes 5 tools for Manatal that AI agents can call directly. - **create_a_manatal_candidate_attachment** — Create a candidate attachment in Manatal. Requires candidate_id. Returns id, name, description, file (URL of the attachment), creator, and created_at fields in the response. - **create_a_manatal_candidate_note** — Create a new note for a specific candidate in Manatal using candidate_id. Returns id, info, creator, and created_at of the created note. - **list_all_manatal_candidate_notes** — List candidate-notes for a specific candidate in Manatal. Requires candidate_pk. Returns id, info, creator, and created_at fields for each note. - **delete_a_manatal_candidate_note_by_id** — Delete a specific candidate note in Manatal using candidate_pk and id. Returns a 204 response to confirm successful deletion. - **create_a_manatal_candidate_resume** — Create a resume for a specific candidate in Manatal using candidate_id. Returns id, resume_file (URL to the uploaded file), and created_at (timestamp of upload). ## How it works 1. **Link your customer's Manatal 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 Manatal.** The Proxy API is a 1-to-1 mapping of the Manatal 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 AI interview results into candidate profiles** — AI interviewing platforms can automatically post screening summaries as candidate notes and upload full transcripts or audio recordings as attachments in Manatal, keeping recruiters in the loop without manual data entry. - **Sync sourced candidates with parsed resumes into Manatal** — Candidate sourcing and enrichment tools can push newly discovered profiles directly into Manatal by uploading resumes, enabling Manatal's AI recommendation engine to immediately score and match candidates to open roles. - **Automate background check status updates on candidate timelines** — Background verification providers can log real-time check progress as candidate notes, clean up outdated statuses, and attach final compliance reports — giving recruiters a single source of truth without switching tools. - **Map Manatal users to your platform's user directory** — SaaS products that need to attribute actions to specific recruiters or hiring managers can use Truto's Unified APIs to resolve Manatal user IDs against the broader organization directory, ensuring correct ownership and routing. - **Centralize external assessment documents on candidate profiles** — Skills assessment and coding test platforms can automatically attach score reports, portfolios, or certification documents to the right candidate in Manatal, eliminating the need for recruiters to download and re-upload files. ## What you can build - **Automated interview transcript attachment** — Upload PDF or audio transcripts from AI screening calls directly to a candidate's Manatal profile using the candidate attachment API. - **Real-time background check timeline** — Post chronological status notes on a candidate's profile as each verification step completes, and remove outdated notes when a step is restarted. - **One-click resume push from sourcing tools** — Let recruiters send a scraped or generated resume to Manatal in one click so the platform's AI can immediately parse and score the candidate. - **Recruiter-to-user identity mapping** — Resolve Manatal recruiter IDs to your product's internal users via the Unified User Directory and ATS User APIs, ensuring notes and attachments are attributed to the right person. - **Candidate note audit log** — List all existing notes on a candidate before writing new ones, preventing duplicate entries and giving your app full context on prior feedback. - **Compliance document vault sync** — Automatically push signed offer letters, ID verifications, or regulatory documents into Manatal as candidate attachments with full metadata for audit trails. ## FAQs ### What operations does Truto support for Manatal today? Truto supports creating candidate attachments, creating and uploading candidate resumes, listing all candidate notes, creating candidate notes, and deleting candidate notes by ID. Additionally, Truto's Unified ATS API exposes Users, and the Unified User Directory API provides access to Users, Organizations, and Activities. ### Can I read or write candidate records directly through Truto? The current toolset focuses on candidate-adjacent objects: notes, attachments, and resumes. Candidate creation or profile field updates are not among the currently listed tools. Contact Truto if you need additional endpoints — integrations can be extended on request. ### How does authentication work for connecting a user's Manatal account? Manatal uses API key-based authentication. Your end users provide their Manatal API key through Truto's managed auth flow, so you never have to handle or store credentials directly. ### Can I delete or update candidate notes programmatically? You can delete a specific candidate note by its ID using the delete tool. To update a note, the typical pattern is to delete the outdated note and create a new one, since a direct update endpoint is not listed among the available tools. ### How does Truto handle pagination and rate limits for Manatal? Truto abstracts away Manatal's pagination logic — for example, when listing candidate notes, Truto handles cursor or page-based pagination automatically. Rate limit retries and back-off are managed by Truto's proxy layer so your application doesn't need to implement them. ### What is the Unified ATS API used for with Manatal? The Unified ATS API currently exposes Users from Manatal. This lets you enumerate recruiters and hiring managers in the Manatal account using a standardized schema, making it easy to attribute notes or attachments to the correct team member across multiple ATS integrations.