Sapilon becomes publicly available on 1 December 2026: 42 days to go. The core goes open source the same day →

Mercury integration

In short

Read bank accounts, balances and transactions. Connect it on the Integrations page; your app then calls Mercury through Sapilon without ever holding a Mercury credential.

Lets your app read your Mercury bank accounts, their balances and transactions. It cannot send money.

Connecting

On the Integrations page choose Connect on Mercury and fill in:

  • API token — Mercury → Settings → API tokens → Generate, with Read Only access.

Sapilon checks the key with the provider before it saves it, and stores it encrypted; it is never shown again.

  • Use a Read Only token. Mercury may ask you to allowlist an IP address for write tokens; read-only tokens work without.

What your app can do

Only these requests are available; anything else is refused.

  • GET /accounts
  • GET /account/*
  • GET /account/*/transactions
  • GET /account/*/transaction/*

How the agent uses it

Use integrations.request('mercury', …); paths are relative to https://api.mercury.com/api/v1.

  • GET /accounts — every account with currentBalance and availableBalance. GET /account/{id}.
  • GET /account/{id}/transactions — Example: { method: 'GET', path: '/account/acc_123/transactions', query: { start: '2026-10-01', end: '2026-10-15', limit: '500' } }.
  • GET /account/{id}/transaction/{transactionId}.

Amounts are dollars (negative = money out). Read-only.

More from Mercury: https://docs.mercury.com/reference

Last updated .

Was this page helpful?