PHPackages                             esign/laravel-unleash-webhook-client - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [HTTP & Networking](/categories/http)
4. /
5. esign/laravel-unleash-webhook-client

ActiveLibrary[HTTP & Networking](/categories/http)

esign/laravel-unleash-webhook-client
====================================

Receive Unleash webhooks within a Laravel application

1.1.0(3mo ago)0559↓16.7%MITPHPPHP ^8.2CI passing

Since Sep 1Pushed 3mo agoCompare

[ Source](https://github.com/esign/laravel-unleash-webhook-client)[ Packagist](https://packagist.org/packages/esign/laravel-unleash-webhook-client)[ Docs](https://github.com/esign/laravel-unleash-webhook-client)[ RSS](/packages/esign-laravel-unleash-webhook-client/feed)WikiDiscussions master Synced today

READMEChangelog (2)Dependencies (12)Versions (6)Used By (0)

Receive Unleash webhooks within a Laravel application
=====================================================

[](#receive-unleash-webhooks-within-a-laravel-application)

[![Latest Version on Packagist](https://camo.githubusercontent.com/768c65a944c1dfd30b467b2b2371d16ee0d23bc5cfd0bf01c50b9495475d29a6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f657369676e2f6c61726176656c2d756e6c656173682d776562686f6f6b2d636c69656e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/esign/laravel-unleash-webhook-client)[![Total Downloads](https://camo.githubusercontent.com/4e7dc4e19f72e6c452fed9554e16a75dabd04fffc9a2d0b021dc01c82f744eee/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f657369676e2f6c61726176656c2d756e6c656173682d776562686f6f6b2d636c69656e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/esign/laravel-unleash-webhook-client)[![GitHub Actions](https://github.com/esign/laravel-unleash-webhook-client/actions/workflows/main.yml/badge.svg)](https://github.com/esign/laravel-unleash-webhook-client/actions/workflows/main.yml/badge.svg)

This package builds on top of [Spatie's Laravel Webhook Client package](https://github.com/spatie/laravel-webhook-client) to provide handling of [Unleash](https://www.unleash.be) webhooks in Laravel applications.

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require esign/laravel-unleash-webhook-client
```

Configuration
-------------

[](#configuration)

You may follow the steps under the [configuration section](https://github.com/spatie/laravel-webhook-client#configuring-the-package) of Spatie's Laravel Webhook Client package.

You can find the `WEBHOOK_CLIENT_SECRET` in the website's configuration section of Unleash.
To set up a webhook, register a new webhook under the Webhooks section for the desired module.
Set the webhook URL to the route you have configured in your Laravel application, for example: `Route::webhooks('unleash-webhook');`

Processing webhooks
-------------------

[](#processing-webhooks)

To process the webhook, extend the `Esign\UnleashWebhookClient\Jobs\ProcessUnleashWebhookJob` job in your application.
You can use its `getWebhookEntries` method to extract the relevant data from the webhook payload and process it as needed.

```
namespace App\Jobs;

use App\Models\Redirect;
use App\Models\Translation;
use Esign\UnleashWebhookClient\Jobs\ProcessUnleashWebhookJob as BaseProcessUnleashWebhookJob;

class ProcessUnleashWebhookJob extends BaseProcessUnleashWebhookJob
{
    public function handle(): void
    {
        foreach ($this->getWebhookEntries() as $webhookEntry) {
            match ($webhookEntry->table) {
                (new Translation)->getTable() => $this->handleTranslationsWebhook($webhookEntry),
                (new Redirect)->getTable() => $this->handleRedirectsWebhook($webhookEntry),
                default => null,
            };
        }
    }

    protected function handleTranslationsWebhook(WebhookEntry $webhookEntry): void
    {
        // Handle the translation webhook entry
    }

    protected function handleRedirectsWebhook(WebhookEntry $webhookEntry): void
    {
        // Handle the redirects webhook entry
    }
}
```

Mocking Unleash Webhooks in Tests
---------------------------------

[](#mocking-unleash-webhooks-in-tests)

This package provides a `MocksUnleashWebhooks` trait to simplify testing Unleash webhook integrations in your Laravel application. The trait allows you to easily send signed webhook requests using fixture files or custom payloads.

```
use Esign\UnleashWebhookClient\Testing\MocksUnleashWebhooks;

class ExampleTest extends TestCase
{
    use MocksUnleashWebhooks;

    #[Test]
    public function it_can_process_unleash_webhooks(): void
    {
        $responseA = $this->makeUnleashWebhookRequest(['example' => 'data']);
        $responseB = $this->makeUnleashWebhookRequestFromFixture('example-webhook.json');

        $responseA->assertOk();
        $responseB->assertOk();
    }
}
```

By default, fixture files are expected to be located in the `tests/Fixtures/UnleashWebhooks/` directory. You may provide a custom path for the fixture files using the `usingUnleashWebhookFixturePath(?string $path)` method.

Running Tests
-------------

[](#running-tests)

```
composer test
```

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance80

Actively maintained with recent releases

Popularity17

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 69.2% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~197 days

Total

2

Last Release

107d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4599d7a8f6fdb63dd04305a49ae5ec9700b7a6eacdbe3a54f89584d75e34503f?d=identicon)[esign](/maintainers/esign)

---

Top Contributors

[![jordyvanderhaegen](https://avatars.githubusercontent.com/u/24370626?v=4)](https://github.com/jordyvanderhaegen "jordyvanderhaegen (9 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (4 commits)")

---

Tags

esignunleash-webhook-client

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/esign-laravel-unleash-webhook-client/health.svg)

```
[![Health](https://phpackages.com/badges/esign-laravel-unleash-webhook-client/health.svg)](https://phpackages.com/packages/esign-laravel-unleash-webhook-client)
```

###  Alternatives

[mateusjunges/laravel-kafka

A kafka driver for laravel

7253.6M20](/packages/mateusjunges-laravel-kafka)[illuminate/http

The Illuminate Http package.

11937.9M6.9k](/packages/illuminate-http)[binary-cats/laravel-mailgun-webhooks

Handle Mailgun webhooks in a Laravel application

65329.3k](/packages/binary-cats-laravel-mailgun-webhooks)[api-platform/laravel

API Platform support for Laravel

58171.4k14](/packages/api-platform-laravel)[danestves/laravel-polar

A package to easily integrate your Laravel application with Polar.sh

8120.4k](/packages/danestves-laravel-polar)[sebdesign/laravel-viva-payments

A Laravel package for integrating the Viva Payments gateway

4851.0k](/packages/sebdesign-laravel-viva-payments)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)