--- title: FreeAgent API Integration on Truto slug: freeagent category: Accounting canonical: "https://truto.one/integrations/detail/freeagent/" --- # FreeAgent API Integration on Truto **Category:** Accounting **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Users** — The User object represents a User. ### Unified Accounting API - **Accounts** — Account represents bank accounts or a general ledger account - **Company Info** — Company Info represents the company's information - **Contacts** — Contacts represents the company's vendor or a customer - **Expenses** — Expenses represents the expenses of the company - **Invoices** — Invoices represents the invoices of the company - **Journal Entries** — Journal Entries represents the journal entries of the company ## How it works 1. **Link your customer's FreeAgent 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 FreeAgent.** The Proxy API is a 1-to-1 mapping of the FreeAgent 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 invoice creation from billing or CRM platforms** — Subscription billing and CRM SaaS companies can automatically generate and mark invoices as paid in their users' FreeAgent accounts, eliminating manual double-entry and ensuring UK tax compliance stays up to date. - **Sync expenses from spend management tools** — Corporate card and expense management platforms can push categorized expense records directly into FreeAgent, mapped to the correct Chart of Accounts, so micro-business owners stop losing receipts and manually entering transactions. - **Pull ledger data for advanced financial reporting** — FP&A and advisory SaaS products can extract journal entries, account structures, and company info from FreeAgent to power cash flow forecasts, KPI dashboards, and scenario models that go far beyond FreeAgent's native reporting. - **Keep customer and supplier records in sync across sales and finance** — CRMs and field service platforms can sync contacts bi-directionally with FreeAgent so that customer records created by sales or operations teams are immediately available for invoicing without duplicates or stale data. - **Map payroll and HR transactions to the correct ledger accounts** — HR and payroll SaaS companies can fetch their users' Chart of Accounts from FreeAgent to accurately route salary, tax, and benefits entries to the right general ledger codes. ## What you can build - **One-click invoice push on job completion** — Automatically create a FreeAgent invoice with matched contact details when a job, project, or subscription renewal is marked complete in your app. - **Real-time expense categorization and sync** — Map each card transaction or receipt to the user's FreeAgent Chart of Accounts and push a fully categorized expense record without manual input. - **Bi-directional contact sync** — Keep customer and supplier records consistent between your platform and FreeAgent, preventing duplicates and ensuring tax information is always current. - **Automated ledger extraction for advisory dashboards** — Periodically pull journal entries and account balances from FreeAgent to generate interactive financial reports, benchmarks, and forecasts for accountants managing multiple clients. - **Company-aware localization engine** — Fetch FreeAgent company info — currency, tax settings, fiscal year — to automatically configure your app's UI and calculations for each connected business. - **User-to-expense attribution** — Sync the FreeAgent user directory into your platform so you can attribute expenses, billable time, or approvals to the correct team member. ## FAQs ### What authentication method does FreeAgent use? FreeAgent uses OAuth 2.0 for API authentication. Truto handles the full OAuth flow — including token refresh — so your end users connect their FreeAgent accounts without you managing credentials or expiration logic. ### Which Unified APIs does Truto support for FreeAgent? Truto maps FreeAgent to the Unified Accounting API (Accounts, Company Info, Contacts, Expenses, Invoices, Journal Entries) and the Unified User Directory API (Users). These unified models let you use the same schema across multiple accounting integrations. ### Are there specific tools or proxy endpoints available for FreeAgent today? FreeAgent does not have pre-built tools yet — they are built on request. Contact Truto to have any custom tool or proxy endpoint spun up for your specific workflow needs. ### Does Truto handle FreeAgent's API pagination and rate limits? Yes. Truto abstracts away pagination and rate-limit handling so you can fetch complete datasets — like a full contact list or journal entry history — without writing retry or cursor logic yourself. ### Can I write data back to FreeAgent, or is it read-only? The Unified Accounting API supports both read and write operations on supported models. You can create invoices, push expenses, and create or update contacts in FreeAgent through Truto's unified endpoints. ### Is FreeAgent primarily suited for UK-based end users? Yes. FreeAgent is heavily tailored to UK tax regulations including MTD for VAT and Self Assessment. It is offered free to NatWest, RBS, and Ulster Bank business customers, giving it deep penetration in the UK micro-SME market. If your users include UK freelancers, sole traders, or small limited companies, FreeAgent coverage is essential.