---
title: Expensify API Integration on Truto
slug: expensify
category: Accounting
canonical: "https://truto.one/integrations/detail/expensify/"
---

# Expensify API Integration on Truto



**Category:** Accounting  
**Status:** Generally available

## MCP-ready AI tools

Truto exposes 17 tools for Expensify that AI agents can call directly.

- **list_all_expensify_policies** — List the policies (workspaces) the authenticated user can access.
- **get_single_expensify_policy_by_id** — Get one policy's categories, report fields, tags, tax rates and employees, keyed by policy ID.
- **create_a_expensify_policy** — Create a new policy (workspace).
- **update_a_expensify_policy_category_by_id** — Merge or replace a policy's categories.
- **update_a_expensify_policy_tag_by_id** — Replace a policy's tag levels and tags (inline JSON).
- **update_a_expensify_policy_report_field_by_id** — Merge or replace a policy's report fields.
- **update_a_expensify_tag_approver_by_id** — Set or clear the approver for single-level tags on a policy.
- **create_a_expensify_expense** — Create one or more expenses in an employee's account.
- **create_a_expensify_report** — Create a report with expenses on a policy (must be enabled for the domain by Expensify).
- **expensify_reports_export** — Start a JSON export of reports and their expenses; returns the generated file name to pass to files.get.
- **expensify_reports_mark_as_paid** — Mark Approved reports as Reimbursed.
- **get_single_expensify_file_by_id** — Download a file generated by reports.export or reconciliations.create.
- **create_a_expensify_reconciliation** — Generate a company-card reconciliation file for a domain (domain admins only) using your FreeMarker template; download it with files.get using file_system=reconciliation.
- **list_all_expensify_domain_cards** — List the company cards assigned on a domain.
- **expensify_employees_bulk_update** — Add, update or remove policy members in bulk (Advanced Employee Updater).
- **create_a_expensify_expense_rule** — Create an expense rule for a policy member.
- **update_a_expensify_expense_rule_by_id** — Update an existing expense rule for a policy member.

## How it works

1. **Link your customer's Expensify 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 Expensify.** The Proxy API is a 1-to-1 mapping of the Expensify 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 expense capture inside travel and procurement tools** — Travel booking, procurement, or software marketplace platforms can push completed purchases directly into their users' Expensify accounts as pre-filled expenses with attached receipts, eliminating manual re-entry for employees.
- **Sync your ERP's chart of accounts into Expensify policies** — Accounting and ERP products can push GL accounts, departments, classes, and project codes into Expensify as Categories, Tags, and Report Fields, enforcing clean coding at the point of expense creation and pulling approved reports back for posting.
- **Automate employee lifecycle for finance teams** — HRIS, payroll, and IT management platforms can bulk-provision new hires into the correct Expensify policy, assign approvers by tag, apply spend rules, and instantly deprovision terminated employees to cut off access to corporate spend.
- **Offer native card reconciliation for corporate card programs** — FinTechs and corporate card issuers can list managed cards and submit end-of-cycle reconciliation files to Expensify, giving finance admins an automated match between card settlements and submitted receipts during month-end close.
- **Close the reimbursement loop for AP and payments platforms** — Bill pay and AP automation tools can export approved Expensify reports, run them through their payment rails, then mark reports as paid in Expensify so employees get real-time reimbursement status without finance teams updating two systems.

## What you can build

- **One-click expense push from your product** — Use create_a_expensify_expense to drop merchant, amount, date, and receipt image into an employee's Expensify account the moment a purchase happens in your app.
- **Chart-of-accounts sync to Expensify policies** — Mirror your users' GL accounts and dimensions into Expensify Categories, Tags, and Report Fields with the policy update endpoints so every expense is coded correctly before it's submitted.
- **Approval routing by department or project** — Use update_a_expensify_tag_approver_by_id to programmatically assign the right manager as the approver for each tag, so expenses tied to a project or department route to the correct reviewer.
- **Automated expense rules at onboarding** — Ship a rules engine that calls create_a_expensify_expense_rule and update_a_expensify_expense_rule_by_id to auto-apply policy logic (auto-approve thresholds, category defaults) whenever a new user is added.
- **Approved-report export and GL posting** — Trigger expensify_reports_export, retrieve the output with get_single_expensify_file_by_id, and push the structured data into your accounting system as bills or journal entries.
- **Reimbursement status writeback** — After your payment platform disburses funds, call expensify_reports_mark_as_paid so Expensify reflects the payment and employees get notified—no duplicate payouts, no manual admin work.
- **Bulk employee provisioning and offboarding** — Use expensify_employees_bulk_update to add new hires to the correct policy, assign managers, and remove terminated employees in a single sync from your HRIS.
- **Corporate card reconciliation feed** — List managed cards with list_all_expensify_domain_cards and submit settlement files via create_a_expensify_reconciliation so finance teams can match card transactions to receipts automatically.

## FAQs

### How does authentication to Expensify work through Truto?

Expensify uses a partnerUserID and partnerUserSecret credential pair scoped to a specific policy or account. Your end users provide these during the Truto-hosted connection flow (or you pass them via API), and Truto stores and rotates them so you never handle raw credentials.

### Can we create expenses on behalf of an end user without them opening Expensify?

Yes. The create_a_expensify_expense tool lets you draft expenses—merchant, amount, date, category, and attached receipt file—directly into a user's account so they appear as unsubmitted items ready to be added to a report.

### How do we pull approved expense data back into our system?

Expensify uses an asynchronous export pattern: call expensify_reports_export with a FreeMarker template to trigger a job, then fetch the resulting file with get_single_expensify_file_by_id. Truto handles the polling and file retrieval so you receive structured data downstream.

### Can we sync custom dimensions like departments, classes, or projects?

Yes. Expensify models these as Tags and Report Fields on a Policy. Use update_a_expensify_policy_tag_by_id and update_a_expensify_policy_report_field_by_id to overwrite those lists, and update_a_expensify_tag_approver_by_id to map approvers to specific tag values.

### How do we close the loop after reimbursing an employee outside Expensify?

After your payment system settles the reimbursement, call expensify_reports_mark_as_paid with the report ID. This updates the report status in Expensify, notifies the employee, and prevents duplicate payouts from in-app reimbursement.

### Does Truto support bulk employee management for onboarding and offboarding?

Yes. The expensify_employees_bulk_update tool lets you add, update, or remove multiple employees from a policy in a single call, which is the pattern used for HRIS-driven provisioning and instant offboarding.

### Is this integration available as a Unified API?

Expensify is currently exposed as a dedicated connector with the tools listed above. A unified Accounting API covering Expensify is on the roadmap—reach out if you'd like it prioritized for your use case.

## Related reading

- [Connect Expensify to Claude: Manage Policies and Reconciliation](https://truto.one/blog/connect-expensify-to-claude-manage-policies-and-reconciliation/) — Learn how to build a managed MCP server to connect Expensify to Claude. Automate expense reports, policy management, and financial reconciliation securely.
- [Connect Expensify to ChatGPT: Sync Expenses and Automate Reports](https://truto.one/blog/connect-expensify-to-chatgpt-sync-expenses-and-automate-reports/) — Learn how to connect Expensify to ChatGPT using Truto's auto-generated MCP server. Sync expenses, manage policies, and automate financial reports with AI.
- [Connect Expensify to AI Agents: Bulk Update Staff and Rules](https://truto.one/blog/connect-expensify-to-ai-agents-bulk-update-staff-and-rules/) — Learn how to connect Expensify to AI Agents to automate bulk staff updates, expense rules, and reconciliations using Truto's /tools endpoint and SDKs.
