​
Welcome to Contabull

Contabull is built on an event-driven architecture, providing real-time updates and seamless integration with your systems. To get started with our platform, you’ll need to complete two essential steps:
  1. Create a New Application
  2. Configure Webhooks

​
Why These Steps Are Necessary

​
Creating a New Application

Creating a new application is the first step in establishing a secure connection between your system and Contabull. This process:
  • Generates unique credentials for your integration
  • Allows you to define the permissions and access levels for your application
  • Ensures secure API communication through RSA key pair authentication

Create New Application

Learn how to set up your Contabull application

​
Configuring Webhooks

Webhooks are at the core of Contabull’s event-driven system. By setting up webhooks, you:
  • Receive real-time notifications about important events in your Contabull account
  • Automate workflows and trigger actions in your own systems
  • Ensure your integration stays up-to-date with the latest data and status changes

Configure Webhooks

Set up webhooks to receive real-time event notifications

​
The Power of Event-Driven Integration

By leveraging Contabull’s event-driven architecture, you can:
  • Achieve Real-Time Synchronization: Keep your systems in sync with Contabull’s data without constant polling.
  • Improve Efficiency: Trigger actions only when necessary, reducing unnecessary API calls and processing.
  • Enhance User Experience: Provide instant updates and notifications to your end-users.
  • Scale Easily: Handle high volumes of data and events without overwhelming your systems.

​
Webhook Reliability and Retry Mechanism

To ensure the reliable delivery of webhook events, Contabull implements a robust retry mechanism:
  • Exponential Backoff with Jitter: If a webhook delivery fails, our system will automatically retry using an exponential backoff algorithm with added jitter. This approach helps distribute retry attempts over time, reducing the likelihood of overwhelming your servers during recovery.
  • Acknowledgment Response: To confirm successful receipt of a webhook event, your server should respond with a 200 OK status code. This acknowledgment tells our system that the event was successfully processed and doesn’t need to be retried.
  • Event Replay: In case of any issues or missed events, our webhook management interface includes a section for event replays. This feature allows you to manually trigger a resend of specific events, ensuring you don’t miss critical updates even if there were temporary issues with your webhook endpoint.

​
Getting Started

To begin your integration with Contabull, follow these steps:
  1. Create a New Application: Set up your secure connection to Contabull’s API.
  2. Configure Webhooks: Define which events you want to receive and where to send them.
  3. Integrate with Your Systems: Use our API documentation to build your integration.

Create New Application

Set up your Contabull application

Configure Webhooks

Set up event notifications
By completing these steps, you’ll have a solid foundation for building powerful, real-time integrations with Contabull. Our event-driven approach ensures that your systems will always have the most up-to-date information, enabling you to create responsive and efficient solutions for your users.