Introduction

Welcome to TibiHooks, a robust webhook delivery platform that handles the complexity of reliably delivering events to HTTP endpoints with automatic retries, monitoring, and scalable infrastructure.

What is TibiHooks?

TibiHooks is a webhook delivery system that sits between your application and external services. When something important happens in your app, you send an event to TibiHooks, and it takes care of delivering that event to all registered webhook endpoints with guaranteed delivery, automatic retries, and comprehensive tracking.

Key Features

• Reliable Delivery: Configurable retry strategies (exponential, linear, fixed backoff) with up to 10 attempts
• Scalable Architecture: Async processing enables horizontal scaling without blocking your application
• Developer-Friendly: RESTful API with comprehensive OpenAPI docs at /api/docs
• Self-Service Portal: Per-application portal lets your users manage webhooks without you building UI

Core Concepts

Application: Represents a piece of context in your system. In a typical use case, each of your customers gets their own Application so they can register and manage their own webhooks independently. Each application has a unique API key for authentication.

Webhook: An HTTP endpoint that receives event notifications. Webhooks are registered to an application and receive POST requests when events occur.

Event: A data payload you send to TibiHooks. Can be any JSON structure up to 1MB. When created, TibiHooks automatically delivers it to all registered webhooks for that application.

Delivery: An individual webhook delivery attempt. Tracks status, response, and timing for monitoring and debugging.

Attempt: Retry attempts for failed deliveries, using your configured backoff strategy.

Typical Use Case

The most common pattern is creating one Application per customer in your SaaS platform. This allows each customer to:

• Register their own webhooks independently
• Receive events specific to their account
• Manage their webhooks through their dedicated portal
• Have isolated webhook configurations and API keys

How It Works

1. Create Applications - Create one Application per customer via API, each gets their own API key
2. Register Webhooks - Your customers add HTTP endpoints via their dedicated portal, or you do it programmatically via API
3. Send Events - POST events to /api/event with the customer's API key whenever something happens in their account
4. Automatic Delivery - TibiHooks delivers to all of that customer's webhooks asynchronously
5. Monitor & Retry - Track delivery status in the portal, automatic retries on failures with configurable backoff