NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #997 most downloaded on Packagist
Send webhooks in Laravel apps
Latest stable
4.0.0
Last release 1 months ago
20 Oct 2026
Release timing varies
gaps range from 2 weeks to 12 months
Nearly every release is documented
notes for 53 of 55 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
55 releases · first in 2019
Drag across the ruler to compare, or tap a release to open it.
Webhooks now use Laravel's HTTP client, so application tests can use Http::fake() without replacing the transport.
Webhooks now use Laravel's HTTP client, so application tests can use Http::fake() without replacing the transport.
Webhook-Id header for delivery deduplication.Retry-After minimum delays and full jitter.This is a major release. It requires PHP 8.4 and Laravel 13.
The usual webhook builder API and standard JSON signatures are unchanged. Custom signers must accept the already serialized string $body instead of an array. Result events expose Laravel responses and exceptions rather than Guzzle equivalents, and custom transport/job extension points have changed. Invalid JSON bodies now throw before dispatch. The new delivery ID header is enabled by default and can be disabled; the retry options are opt-in.
Drain old webhook and listener jobs before deployment and restart queue workers on v4. Read UPGRADING.md for all compatibility changes and queue/stream considerations.
Thanks to @alex543644 for the Laravel HTTP-client migration.
Full changelog: https://github.com/spatie/laravel-webhook-server/compare/3.11.0...4.0.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Guzzle 8 is now supported alongside Guzzle 6 and 7.
Guzzle 8 is now supported alongside Guzzle 6 and 7.
Guzzle 8 removes RequestException::getResponse(), keeps the casing of the HTTP method you pass in, and only accepts string header values. All three are handled, so webhooks keep going out as POST and useTimestamp() keeps working. The test matrix now runs against both Guzzle 7 and 8.
Full Changelog: https://github.com/spatie/laravel-webhook-server/compare/3.10.0...3.11.0
## What's Changed - Add Laravel 13 support
Add support for optional timestamp header in webhooks
The timestamp header helps prevent replay attacks. You can enable it by calling useTimestamp():
WebhookCall::create()
->useTimestamp()
->url('https://example.com/webhooks')
->useSecret('my-secret')
->payload(['key' => 'value'])
->dispatch();
The header name defaults to Timestamp and can be configured via the timestamp_header_name config key.
Laravel 12.x Compatibility by @laravel-shift in https://github.com/spatie/laravel-webhook-server/pull/162
Full Changelog: https://github.com/spatie/laravel-webhook-server/compare/3.8.2...3.8.3
Fix CallWebhookJob behaviour when throwExceptionOnFailure is true by @cristian-fleischer in https://github.com/spatie/laravel-webhook-server/pull/161
Full Changelog: https://github.com/spatie/laravel-webhook-server/compare/3.8.1...3.8.2
Add support for laravel 11 by @shuvroroy in https://github.com/spatie/laravel-webhook-server/pull/154
Full Changelog: https://github.com/spatie/laravel-webhook-server/compare/3.8.0...3.8.1
Add event that is being fired upon the webhook's dispatch by @thannaske in https://github.com/spatie/laravel-webhook-server/pull/150
3.8.0
Full Changelog: https://github.com/spatie/laravel-webhook-server/compare/3.7.0...3.8.0
Adds support for mutual TLS by @JonErickson in https://github.com/spatie/laravel-webhook-server/pull/149
Full Changelog: https://github.com/spatie/laravel-webhook-server/compare/3.6.0...3.7.0
Fix webhook event type for raw body by @DotNetSimon in https://github.com/spatie/laravel-webhook-server/pull/147
Full Changelog: https://github.com/spatie/laravel-webhook-server/compare/3.5.0...3.6.0
Webhook option to allow sending a raw body instead of array -> json. by @DotNetSimon in https://github.com/spatie/laravel-webhook-server/pull/146
Full Changelog: https://github.com/spatie/laravel-webhook-server/compare/3.4.3...3.5.0
Change to protected properties $response, $errorType and $errorMessage in CallWebhookJob by @Kazuto in https://github.com/spatie/laravel-webhook-serve
$response, $errorType and $errorMessage in CallWebhookJob by @Kazuto in https://github.com/spatie/laravel-webhook-server/pull/143Full Changelog: https://github.com/spatie/laravel-webhook-server/compare/3.4.2...3.4.3
Fixes a couple of minor typographical errors. by @cxj in https://github.com/spatie/laravel-webhook-server/pull/141
Full Changelog: https://github.com/spatie/laravel-webhook-server/compare/3.4.1...3.4.2
Add PHP 8.2 Support by @patinthehat in https://github.com/spatie/laravel-webhook-server/pull/138
Full Changelog: https://github.com/spatie/laravel-webhook-server/compare/3.4.0...3.4.1
Add proxy option by @andycowan in https://github.com/spatie/laravel-webhook-server/pull/136
Full Changelog: https://github.com/spatie/laravel-webhook-server/compare/3.3.0...3.4.0
Add missing config documentation to readme by @Kazuto in https://github.com/spatie/laravel-webhook-server/pull/134
Full Changelog: https://github.com/spatie/laravel-webhook-server/compare/3.2.1...3.3.0
Allow sub-classes of CallWebhookJob to use a GuzzleHttp\Client specific for outgoing webhooks by @bezhermoso in https://github.com/spatie/laravel-webh
CallWebhookJob to use a GuzzleHttp\Client specific for outgoing webhooks by @bezhermoso in https://github.com/spatie/laravel-webhook-server/pull/125Full Changelog: https://github.com/spatie/laravel-webhook-server/compare/3.2.0...3.2.1
feat: add dispatchIf, dispatchUnless, dispatchSyncIf and dispatchSync… by @regnerisch in https://github.com/spatie/laravel-webhook-server/pull/124
Full Changelog: https://github.com/spatie/laravel-webhook-server/compare/3.1.2...3.2.0
- support Laravel 9
Include Exception with Laravel queue failures by @awarrenlove in https://github.com/spatie/laravel-webhook-server/pull/114
Full Changelog: https://github.com/spatie/laravel-webhook-server/compare/3.1.0...3.1.1
Updating README to show how to use the package in automated tests by @MajorasJack in https://github.com/spatie/laravel-webhook-server/pull/100
dispatchSync() by @expertcoder in https://github.com/spatie/laravel-webhook-server/pull/96Full Changelog: https://github.com/spatie/laravel-webhook-server/compare/3.0.0...3.1.0
support using webhook URLs as part of webhook signatures
The only breaking change in this release is the addidation of string $webhookUrl to the calculateSignature method of the Signer interface.
If you have a custom Signer in your project, add that $webhookUrl to the calculateSignature method.
add ability to use default queue of connection
- allow setting queue connection
- fix tests
- require Laravel 8 - require PHP 8
No changes to the API were made, so you can safely upgrade from v1 to v2
- add dispatchSync
dispatchSyncpass Guzzle TransferStats into resulting Event
fix for missing default headers when using withHeaders
dispatch should return the PendingDispatch
fix exception name for invalid signers
- add support for PHP 8
- add getUuid
getUuid- support Guzzle 7
- support Laravel 8
- do not use body in GET request
- add doNotSign
doNotSign- fix uuid
uuid- add uuid
uuid- add dispatchNow
dispatchNow (#39)- add support for Laravel 7
- drop support for PHP 7.3
add error info to the dispatched event
- remove duplicate line
do not release job on last attempt
- add getResponse
getResponse- Add Laravel 6 support
avoid sending unsuccessfull event when the final try of a job succeeds
remove constructor on WebhookCallFailedEvent so it inherits properties
WebhookCallFailedEvent so it inherits propertiesadd ContentType header with value application/json by default
ContentType header with value application/json by defaultmove test-time to dev dependencies
test-time to dev dependencies- fixed method names
contains bug, do not use - initial release
contains bug, do not use
Nothing published for this version
Nothing published for this version
One column per quarter.