--- title: Mambu API Integration on Truto slug: mambu category: Default canonical: "https://truto.one/integrations/detail/mambu/" --- # Mambu API Integration on Truto **Category:** Default **Status:** Beta ## How it works 1. **Link your customer's Mambu 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 Mambu.** The Proxy API is a 1-to-1 mapping of the Mambu 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 client onboarding from KYC and identity verification platforms** — If your SaaS handles identity verification or digital onboarding, you can push verified customer profiles directly into your users' Mambu instance — creating clients, updating KYC status fields, and ensuring the core banking ledger is always in sync with compliance workflows. - **Sync loan lifecycle events into collections and recovery workflows** — Collections platforms need real-time visibility into arrears, penalty balances, and borrower data from the core ledger. Integrating with Mambu lets your SaaS react to loan state changes and push repayment transactions back once debts are recovered. - **Export GL journal entries into accounting and ERP systems** — Financial operations tools can pull daily interest accruals, fee income, and other journal entries from Mambu's general ledger, eliminating manual CSV reconciliation and automating the monthly close process for banks and fintechs. - **Push approved loan terms from origination systems into the core ledger** — Loan origination platforms that handle underwriting and credit decisioning need to create fully configured loan accounts in Mambu upon approval — including interest rates, repayment schedules, and collateral details — so the ledger can begin servicing the loan automatically. - **Surface real-time account data inside CRM and support tools** — CRM and customer support platforms can pull live deposit balances, active loan details, and transaction history from Mambu so agents have full financial context without switching systems. ## What you can build - **Automated client creation on KYC approval** — When a customer passes identity verification in your platform, automatically create or update their client profile in the end user's Mambu environment with all relevant custom fields. - **Real-time arrears detection and collections triggering** — Listen for Mambu loan account state changes and automatically pull borrower contact details and outstanding balances to kick off dunning sequences in your collections product. - **Nightly GL journal entry sync to ERP** — Run scheduled extracts of Mambu's general ledger journal entries, aggregate micro-transactions into standardized accounting batches, and post them to your users' ERP. - **One-click loan account provisioning from your LOS** — Let loan officers approve a deal in your origination system and have the fully configured loan account — product type, terms, schedule, fees — created in Mambu without manual re-entry. - **Deposit account balance and transaction feed** — Pull checking and savings account balances, authorization holds, and transaction history from Mambu to display inside your product's dashboards or reporting views. - **Repayment and disbursement write-back** — Post repayment transactions or disbursement records back into Mambu loan accounts directly from your SaaS, keeping the ledger accurate without requiring users to log into Mambu. ## FAQs ### How does authentication work with Mambu's API? Mambu API v2 supports API key-based authentication. Each end user provides their Mambu tenant URL and an API key (or username/password credentials for basic auth). Truto handles credential storage and request signing so your application doesn't manage secrets directly. ### Does Mambu support webhooks for event-driven integrations? Yes. Mambu supports configurable webhooks that fire on specific ledger events such as LoanAccountStateChanged, TransactionCreated, and others. This enables real-time, event-driven workflows like collections triggering or balance change notifications. ### Can I read and write custom fields on Mambu objects? Yes. Mambu allows custom fields (called 'Custom Field Sets') on clients, loan accounts, deposit accounts, and other entities. These are fully accessible via the API, so you can read and update fields like KYC_Status or any business-specific data your end users have configured. ### Is this integration available today on Truto? Mambu is available as a build-on-request integration. Truto builds and ships new integrations quickly based on the specific endpoints and workflows your product needs. Reach out to scope your Mambu integration and get a timeline. ### What Mambu API version does Truto target? Truto targets Mambu's API v2, which is the current standard and covers clients, loan accounts, deposit accounts, GL journal entries, and transactions. API v2 is REST-based and returns JSON responses. ### How does Truto handle pagination and rate limits for Mambu? Mambu's API v2 uses offset-based pagination with configurable page sizes. Truto abstracts pagination so your application receives complete result sets without manual page management. Rate limit handling, including retries and backoff, is managed by Truto automatically.