laravel-webhooks maintained by boone-studios
boone-studios/laravel-webhooks
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