Webhooks let you receive real-time notifications about events in your BankSync account. Build automations that respond instantly when feeds sync, new transactions arrive, or errors need attention.
Real-Time
Instant event notifications
Sync Events
Know when feeds complete
New Data
Get notified of new transactions
Error Alerts
Catch failures immediately
Available Events
feed.sync.completed
A feed finished syncing successfully
feed.sync.failed
A feed sync encountered an error
transactions.new
New transactions were synced
connection.status.changed
A bank connection status changed
connection.requires.attention
A connection needs re-authentication
receipt.processed
A receipt was extracted successfully
Setting Up Webhooks
Configuration Steps
Go to Settings > Webhooks
Navigate to the webhook configuration in your BankSync settings.
Add endpoint URL
Enter the HTTPS URL where you want to receive webhook events.
Select events
Choose which events should trigger notifications to your endpoint.
Copy signing secret
Save the signing secret to verify webhook authenticity.
Test the webhook
Use the Test button to send a sample event to your endpoint.
Webhook Payload
Webhooks are sent as HTTP POST requests with a JSON payload:
event
Event type (e.g., feed.sync.completed)
timestamp
ISO 8601 timestamp of event
data
Event-specific payload data
Verifying Webhooks
Each webhook includes a signature in the X-BankSync-Signature header. Verify it by computing HMAC-SHA256 of the request body using your signing secret.
Retry Policy
Automatic Retries
Failed webhooks retry up to 5 times
Exponential Backoff
Increasing delays between retries
2xx Required
Return 200-299 status to acknowledge
Common Use Cases
Slack Notifications
Send alerts to Slack when syncs complete or fail
Custom Dashboards
Update dashboards in real-time as data arrives
Workflow Automation
Trigger Zapier or Make workflows on events
Monitoring
Integrate with PagerDuty for error alerting