PHPackages                             faaren-tech/webhook-receiver - 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 &amp; Networking](/categories/http)
4. /
5. faaren-tech/webhook-receiver

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

faaren-tech/webhook-receiver
============================

Build to receive webhooks.

v1.0.0rc2(4y ago)19MITPHP

Since Jan 31Pushed 3y ago5 watchersCompare

[ Source](https://github.com/FAAREN-tech/webhook-receiver)[ Packagist](https://packagist.org/packages/faaren-tech/webhook-receiver)[ RSS](/packages/faaren-tech-webhook-receiver/feed)WikiDiscussions main Synced today

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

FAAREN-Tech
===========

[](#faaren-tech)

Open Tasks
----------

[](#open-tasks)

1. Add authorization logic (e.g. for Stripe)
2. Custom table name

Webhook Receiver
----------------

[](#webhook-receiver)

This package will be used by all FAAREN Services which receive webhooks. It provides a basic structure to handle incoming webhooks. With this package you can simply define new endpoints for webhooks. Those webhooks will be stored within a database. Via a simple HandlerInterface you can define custom handlers for each of your endpoints.
This package also offers a basic CRUD functionality to interact with your stored webhooks via the `Webhook` model.

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

[](#installation)

Call the following command:

```
composer require faaren-tech/webhook-receiver
```

The package is tested only for Laravel 8.x.

Config
------

[](#config)

Publish the relevant configuration file via (select the WebhookReceiverServiceProvider from the shown list):

```
php artisan vendor:publish
```

- You can customize the middleware separately for webhook endpoints and crud-routes.
- You can customize the prefix for both the webhook endpoints and the crud-routes.

Creating new endpoints
----------------------

[](#creating-new-endpoints)

It is very easy to add new endpoints to your application.

1. Create a new webhook handler, e.g. `MyExampleWebhookHandler` within `app/Http/WebhookEndpoints`
2. Implement `FaarenTech\WebhookReceiver\Interfaces\WebhookEndpointHandlerInterface`
3. Add the endpoint to your `config/webhook_receiver` configuration file (see below)
4. Set up your new endpoint within your webhook sender (e.g. MailJet, Stripe, etc) for the endpoint `webhook/endpoints/my-example-endpoint`

```
return [
    // other configuration options
    'endpoints' => [
        'my-example-endpoint' => MyExampleWebhookHandler::class
    ]
];
```

Example files
-------------

[](#example-files)

If you want you can take a look at the following files:

- [ExampleRequests](example-requests.rest): Some simple examples. Can be executed directly from your favorite IDE (PhpStorm ;-))
- [ExampleHandler](src/Http/WebhookEndpoints/ExampleEndpointHandler.php): a example implementation

Testing
-------

[](#testing)

Add the relevant testsuite to your main phpunit.xml:

```

    ...

        ./vendor/faaren-tech/webhook-receiver

```

###  Health Score

20

—

LowBetter than 13% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity39

Early-stage or recently created project

 Bus Factor1

Top contributor holds 85.7% 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 ~0 days

Total

3

Last Release

1612d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/91635494?v=4)[faaren](/maintainers/faaren)[@Faaren](https://github.com/Faaren)

---

Top Contributors

[![Brotzka](https://avatars.githubusercontent.com/u/9106911?v=4)](https://github.com/Brotzka "Brotzka (18 commits)")[![domacs](https://avatars.githubusercontent.com/u/2152330?v=4)](https://github.com/domacs "domacs (2 commits)")[![FredFaaren](https://avatars.githubusercontent.com/u/95489887?v=4)](https://github.com/FredFaaren "FredFaaren (1 commits)")

### Embed Badge

![Health badge](/badges/faaren-tech-webhook-receiver/health.svg)

```
[![Health](https://phpackages.com/badges/faaren-tech-webhook-receiver/health.svg)](https://phpackages.com/packages/faaren-tech-webhook-receiver)
```

###  Alternatives

[pestphp/pest

The elegant PHP Testing Framework.

11.6k72.2M20.1k](/packages/pestphp-pest)[drupal/core-dev

require-dev dependencies from drupal/drupal; use in addition to drupal/core-recommended to run tests from drupal/core.

2022.6M341](/packages/drupal-core-dev)[php-http/client-integration-tests

HTTP Client integration tests

1778.3k28](/packages/php-http-client-integration-tests)

PHPackages © 2026

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