- Base URL:
https://api.finta.io/v2 - Format: JSON
- Authentication: Bearer token (API key or OAuth access token)
Manual accounts
Most accounts in Finta sync automatically from a connected bank. Manual accounts are ones you maintain yourself: cash, a property, a private loan, or a credit card you’d rather track by hand.POST /accountscreates a manual account. SetcurrentBalanceto the amount owed for liabilities, and pass aliabilityobject (typeofcredit,student, ormortgage) to record debt details.PATCH /accounts/{accountId}updates the name, type, currency, balance, or liability data. Updating the balance records a balance-history snapshot for that day.DELETE /accounts/{accountId}closes the account (soft delete): it moves toclosedstatus but keeps its transactions and balance history.
name, and returns 400 for any other field. Syncs keep that name; the bank’s name is returned as institutionAccountName. Manual account changes automatically sync to any connected destinations (Airtable, Notion, Google Sheets, etc.) the account is linked to.
If your API key (or OAuth client) is scoped to a specific set of accounts, an account it creates is automatically added to that allowlist, so the same credential can read and manage it right away.
Requirements
Rate limits
Limits are per user and separate from MCP’s.
The free trial gets Standard limits, or Pro limits if you’re trialing Pro.
Requests that exceed the limit return
429 RATE_LIMITED. The response carries a Retry-After header with the number of seconds to wait before retrying.
Errors
Most errors use a structured envelope:
Every
message in the envelope ends with a sentence pointing to POST /feedback, with the response’s requestId.
Feedback
If the API gets in your agent’s way (a bug, unclear docs, an error that doesn’t say how to fix it, or a missing feature), send a report toPOST /feedback with kind, attempted and actual. Add operation (the route, such as POST /v2/transactions) and the requestId from the error when the report is about one call; leave them out for general feedback about Finta. Finta reads every report. It works with any API key or OAuth token, even without Storage Mode or an active subscription, and allows 20 reports an hour. Feedback calls don’t count toward the rate limits and still work when you have hit them. Check on a report with GET /feedback/{id}. MCP clients use the submit_feedback and get_feedback_status tools.
401 responses use a plain string rather than the envelope: