This guide helps you diagnose and resolve common issues you might encounter when using BankSync. Find solutions for connection problems, sync failures, and data issues.
Connection Issues
Problems connecting to banks or destinations
Sync Failures
Feeds not running or completing properly
Destination Errors
Issues writing to Notion, Sheets, or Airtable
Data Problems
Missing, duplicate, or incorrect data
Bank Connection Issues
Connection Troubleshooting Steps
Check your bank's status
Visit your bank's website or app to ensure online banking is working. Some banks have maintenance windows.
Verify your credentials
Ensure you're using the correct username and password. Try logging into your bank directly first.
Complete any MFA challenges
Look for text messages, emails, or app notifications for verification codes.
Reconnect if needed
Go to the Banks tab, find the connection, and click Reconnect to re-authenticate.
Common Bank Connection Errors
Invalid Credentials
Double-check username/password. Some banks use different credentials for third-party access.
Session Timeout
The connection took too long. Try again when you have a stable internet connection.
MFA Required
Complete the multi-factor authentication challenge sent to your phone or email.
Bank Maintenance
Your bank may be performing maintenance. Try again in a few hours.
Feed Sync Issues
Feed Troubleshooting Steps
Check feed status
Go to your Feeds page and look for error indicators. Red status means a failure occurred.
Review the sync job
Click on the feed to see the latest sync job details and any error messages.
Verify bank connection
Ensure the underlying bank connection is healthy in the Banks tab.
Check destination connection
Verify your destination (Notion, Sheets, Airtable) is still connected in the Connections tab.
Retry the sync
Use the Run Now button to manually trigger a new sync attempt.
Destination Issues
Notion
Permission Denied
Re-authorize Notion and ensure BankSync has access to the target database.
Database Not Found
The database may have been deleted or moved. Select a new database in your feed settings.
Property Mismatch
Database properties changed. Update your field mappings to match the current schema.
Rate Limited
Notion API limits reached. The sync will automatically retry later.
Google Sheets
Access Revoked
Re-authorize Google Sheets in the Connections tab to restore access.
Sheet Not Found
The spreadsheet may have been deleted or unshared. Select a new sheet.
Row Limit Reached
Google Sheets has a 10 million cell limit. Archive old data or use a new sheet.
Quota Exceeded
Google API quota reached. Syncs will resume automatically.
Airtable
Token Expired
Re-authorize Airtable in the Connections tab with a new personal access token.
Base Not Found
The base may have been deleted. Select a different base for your feed.
Field Type Mismatch
Field types changed in Airtable. Update your mappings to match.
Record Limit
Free Airtable plans have record limits. Upgrade or archive old data.
Data Issues
Missing Data
Resolving Missing Data
Check date range
Verify your feed's date range includes the missing transactions. Adjust the lookback period if needed.
Verify bank data
Check if the transactions appear in your bank's online portal. Pending transactions may not sync.
Review filters
Check if you have any filters applied that might exclude certain transactions.
Trigger historical sync
Some feeds support pulling additional historical data. Check your feed settings.
Duplicate Data
Fixing Duplicates
Check for duplicate feeds
Ensure you only have one feed per bank account syncing to each destination.
Clean up destination
Remove duplicate entries from your destination manually or with filters.
Reset the feed
If duplicates persist, you may need to delete the feed and create a new one.