> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asteragents.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Expensify

> Query expense reports and create expenses with shared or individual API credentials

Expensify connects through its Integration Server API using a Partner User ID and Partner User Secret. An admin can choose one shared account or let each member connect an individual account.

## Setup

1. Open **Control Hub > Integrations**, find **Expensify**, and open its settings.
2. Choose **Individual accounts** or **Shared account**.
3. Choose **Read reports and policies** or **Read and create expenses**.
4. For shared access, enter the account email and credentials from [Expensify's integrations page](https://www.expensify.com/tools/integrations/). For individual access, save the settings, then use **Your connections > Expensify > Connect**. Members can also connect directly from a chat using an agent with Expensify tools.
5. Add the tools below to your agent and save it.

Credentials are checked by listing accessible policies before they are saved. This confirms policy access; it does not confirm permission to create expenses or verify that the entered email belongs to those credentials.

<Warning>
  Expensify restricts the expense creation API's employee email parameter to accounts with advanced permissions. An individual API credential does not automatically grant those permissions. If creation is denied, contact Expensify support to confirm or enable access for your account/domain.
</Warning>

## Tools

| Tool | Purpose |
| - | - |
| `expensify_policies` | List accessible policies or inspect categories, tags, tax rates, report fields, and employees. |
| `expensify_reports` | Query reports and their attached expenses by report ID or report date range. |
| `expensify_create_expense` | Create one expense, optionally attaching it to an existing report. |

Report queries filter on the later of report creation or submission date, **not the expense date**. Date ranges must be no longer than 365 days. Unreported expenses are excluded. A result at the requested limit may be incomplete; narrow the dates or query specific IDs. Reads do not mark reports as exported or send emails.

Expense creation accepts a positive integer amount in cents (`1234` means `12.34`) and an uppercase currency code. Individual mode fixes the destination to the account email entered when connecting. Shared mode can target another employee only when the shared credentials have the necessary Expensify permissions. The pilot does not upload receipts, submit or approve reports, or make payments.

## Managing access

Individual credentials are scoped to the signed-in member and organization. A missing individual connection never falls back to shared credentials. An admin's read-only setting blocks expense creation for both modes.

Use **Reconnect** or **Update credentials** to replace credentials, or **Disconnect** to remove Aster's saved copy. An admin removing the integration removes all saved personal Expensify credentials in that organization. Switching to shared mode removes personal credentials; switching to individual mode removes the shared credentials. Disconnecting Aster does not revoke the key in Expensify.

## Troubleshooting

* **Credentials rejected:** Confirm the Partner User ID and Partner User Secret, then reconnect. Your account must have Integration Server API access.
* **Creation denied:** Ask Expensify support about advanced permissions for the expense creator API. A successful connection test verifies policy reads only.
* **Rate limit:** Expensify allows 5 requests per 10 seconds and 20 per minute. A report query uses two requests: export and download. Wait before trying again.
* **Uncertain creation:** A timeout or incomplete response may occur after the expense is created. Check Expensify before retrying. Aster does not automatically retry writes, and an external reference ID is not a deduplication guarantee.

## OAuth and MCP

This version uses API credentials. Expensify's Integration Server OAuth program requires partner onboarding. Its official MCP currently provides read-only tools, and the hosted Aster callback failed authorization in our launch testing. OAuth is a separate follow-up.

See [Expensify's API documentation](https://integrations.expensify.com/Integration-Server/doc/index.html) for provider permissions and limits.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.