How-to Guide: Connect Banking Circle to Ledge
This guide explains how to connect your Banking Circle account to Ledge using machine-to-machine (M2M) OAuth 2.0 authentication.
You’ll complete the following steps:
Request access via your Banking Circle account manager
Download your certificate from the Banking Circle portal
Configure the connection in the Ledge Admin Portal
🔐 Administrator privileges required
1. Request M2M API Access from Banking Circle
To get started, email your Banking Circle account or integration manager with the following request:
Subject: M2M API User Setup for Ledge Integration for the Production environment Body:
I would like to set up M2M API credentials for Ledge (a third party provider we collaborate with to automate our finance operations). Please configure the following:
API user email:
[email protected]Whitelisted IPs:
34.231.208.110
2. Access Your Certificate in the Portal
📝 Continue to step 2 only once you got a confirmation from Banking Circle and you have the username and password for the Ledge user ([email protected]).
Log in to the Banking Circle Developer Portal
Navigate to the Certificates section
Download the issued certificate
If prompted - reset your certificate passphrase
Download the certificate Thumbprint
Save:
The certificate file ThumbPrint
the Ledge user username and password
3. Configure Ledge user Permissions
In your Banking Circle client portal - configure the permissions for the Ledge API user (created by your Banking Circle account manager):
Allow all relevant Read permissions, including listing accounts and balances and if needed payments/transactions.
Allow generation of CAMT/ISO20022 files
5. Configure Connection in Ledge
Log in to the Ledge Admin portal
Go to Sources → Add Source → Banks → Banking Circle
Click + Add Banking Circle Connection
Fill in the following:
Certificate ThumbPrint: Upload the thumbprint file
Username and Password: of the generated API user
Click Save and notify your Ledge Implementation manager that will verify the integration and permissions and will set up the integration fields/schema and rules
What Data Ledge Will Fetch
Ledge will securely fetch the following data via Banking Circle's read-only APIs:
Accounts
/api/v1/accounts
Balances
/api/v1/accounts/{accountId}/balances
Transactions
/api/v1/accounts/{accountId}/bookings
Reports
/api/v1/reports/... (e.g. camt.053, EOD)
All requests are read-only. Ledge does not modify any data.
Last updated: July 2025
Last updated