README

Outbound signed webhook delivery for Laravel: fan-out, HMAC signatures, queued retries with backoff, delivery logs, and manual replay.

Requirements

• PHP 8.2+
• Laravel 12 or 13

Installation

composer require boone-studios/laravel-webhooks

php artisan vendor:publish --tag=webhooks-config
php artisan vendor:publish --tag=webhooks-migrations
php artisan migrate

Usage

use BooneStudios\Webhooks\Services\WebhookDispatcher;

app(WebhookDispatcher::class)->dispatch($tenant, 'order.created', [
    'event' => 'order.created',
    'order_id' => $order->id,
]);

Configure models, signature header, queue name, and optional event catalog in config/webhooks.php. Defaults use a generic X-Webhook-Signature header — override per app (Forgebit uses X-Forgebit-Signature).

Replay a failed delivery:

use BooneStudios\Webhooks\Services\ReplayWebhook;

app(ReplayWebhook::class)->replay($log);

License

MIT © Boone Studios, LLC