Background Paths
Background Paths
Financbase Logo
Webhooks

Real-time Event Notifications

Receive instant notifications when important events occur in your Financbase account.

Getting Started

1. Create Webhook Endpoint

Set up a secure HTTPS endpoint in your application to receive webhook events.

Requirements:

  • • HTTPS endpoint (HTTP not supported)
  • • Must respond with 2xx status code within 30 seconds
  • • Should handle duplicate events (idempotent)
  • • Validate webhook signature for security

2. Configure Webhook

Register your webhook endpoint in the Financbase dashboard.

Get Started

3. Verify & Test

Test your webhook integration and verify event delivery.

Event Types

Transaction Events

  • transaction.created
  • transaction.updated
  • transaction.categorized

Account Events

  • account.connected
  • account.disconnected
  • account.sync_completed

Payload Example

{
"id": "evt_1234567890",
"type": "transaction.created",
"created": 1640995200,
"data": {
"id": "txn_9876543210",
"amount": -29.99,
"description": "Coffee Shop",
"account_id": "acc_12345"
}
}

Ready to Get Started?

Set up webhooks to receive real-time notifications about your financial data.

Get Started Free