Authenticate
Get your partner access token.Exchange credentials for partner token:
- POST to
/v1/platform/oauth2/token/using Basic Auth - Use partner UUID and API key (provided by Thred)
- Store the returned partner token
Onboard Business
Create a business in Thred when user signs up for accounting.Create business:
- POST to
/v1/platform/businesses/with business details - Use partner token from Step 1
- Store returned
business_idin your database
- POST to
/v1/platform/{business_id}/oauth2/token/ - Use partner token
- Store business-scoped token
Embed Accounting UI
Add Thred’s accounting interface to your platform.Install SDK:Mount widget:
- Add container element to your app
- Call
mountThredfi()with business token - User sees accounting interface in your platform
Push Business Activity
Send financial data as it happens.Required:
- POST invoices when created
- POST payments when received
- POST refunds when issued
- Creates journal entries (double-entry bookkeeping)
- Updates AR/AP balances
- Generates financial reports
Connect Bank Accounts
User connects their bank account (optional).Your user can connect their bank account directly in the embedded Thred UI:
- Click “Connect Bank” in the accounting interface
- Authenticate with their bank (via Plaid)
- Select accounts to sync
- Daily transaction sync
- 2-year history backfill
- Auto-reconciliation with invoices/bills
Verify Integration
Test the complete integration.Create test invoice:
- POST to
/v1/platform/businesses/{id}/invoices/ - Use business token
- Invoice appears in embedded accounting UI (AR tab)
Ready to start? Let’s onboard your first business.