PHPackages                             mcgo/laravel-webhooks - 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. [Utility & Helpers](/categories/utility)
4. /
5. mcgo/laravel-webhooks

ActiveLibrary[Utility & Helpers](/categories/utility)

mcgo/laravel-webhooks
=====================

Turn your Laravel app into a webhook powerhouse.

1.0.1(6mo ago)0462↓33.3%MITPHPCI failing

Since Oct 27Pushed 6mo agoCompare

[ Source](https://github.com/McGo/laravel-webhooks)[ Packagist](https://packagist.org/packages/mcgo/laravel-webhooks)[ RSS](/packages/mcgo-laravel-webhooks/feed)WikiDiscussions v1 Synced 1mo ago

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

laravel-webhooks
================

[](#laravel-webhooks)

> “Your Laravel app, now fluent in webhooks.”

**laravel-webhooks** is a lightweight Laravel package that lets clients register for webhooks via API, including callback URLs and bearer tokens.
Webhooks are stored as models (with UUIDs) and can be triggered by other parts of your Laravel application with automatic retry logic and exponential backoff.

📦 Installation
--------------

[](#-installation)

Install the package via Composer:

```
composer require mcgo/laravel-webhooks
```

Run the migrations:

```
php artisan migrate
```

---

🚀 Usage
-------

[](#-usage)

### Registering a Webhook Client

[](#registering-a-webhook-client)

A client can register itself via API, just add the authentication and route yourself and point it to the shipped controller `McGo\Webhooks\Controllers\PostWebhookRegistration`

```
POST /api/webhooks/register
Content-Type: application/json

{
  "url": "https://client.example.com/webhook",
  "auth_header": "Authorization"
  "auth_token": "Bearer 123"
}
```

Response:

```
{
  "uuid": "a1b2c3d4-…",
  "url": "https://client.example.com/webhook"
}
```

### Dispatching a Webhook

[](#dispatching-a-webhook)

Simply call the action `McGo\Webhooks\Actions\CallWebhookRegistration` or make use of the job that will retry sending when the first attempts did not work.

```
use McGo\Webhooks\Actions\CallWebhookRegistration;
use McGo\Webhooks\Models\WebhookRegistration;
use McGo\Webhooks\Jobs\CallWebhookJob;

$registration = WebhookRegistration::query()....->first();
$payload = ['my' => 'payload']; // or an object
(new CallWebhookRegistration())->execute($registration, $payload);

// or dispatch a job and let the queue do it
dispatch(new CallWebhookJob($registration, $payload);
```

The job will automatically attempt delivery with exponential backoff delays (e.g., 60s, 120s, 240s…).

---

🧪 Testing
---------

[](#-testing)

Run the package phpunit tests.

```
vendor/bin/phpunit
```

---

💡 Contributing
--------------

[](#-contributing)

Contributions are welcome!
Please make sure to follow these guidelines:

- Follow PSR-12 and Laravel code style
- Include unit/feature tests for new functionality
- Update documentation for any added or changed behavior

---

📄 License
---------

[](#-license)

This package is open-sourced software licensed under the [MIT license](LICENSE).

---

🙋 Contact
---------

[](#-contact)

For questions, issues, or feature requests, please open a GitHub issue or contact the maintainer directly.

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance66

Regular maintenance activity

Popularity15

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity35

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% 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

2

Last Release

204d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8d013a76b3f3fbb39055e2db159fe01f71efd504c0712308f776056da3ebddb7?d=identicon)[McGo](/maintainers/McGo)

---

Top Contributors

[![McGo](https://avatars.githubusercontent.com/u/278351?v=4)](https://github.com/McGo "McGo (1 commits)")

### Embed Badge

![Health badge](/badges/mcgo-laravel-webhooks/health.svg)

```
[![Health](https://phpackages.com/badges/mcgo-laravel-webhooks/health.svg)](https://phpackages.com/packages/mcgo-laravel-webhooks)
```

###  Alternatives

[wireui/wireui

TallStack components

1.8k1.3M16](/packages/wireui-wireui)[livewire/volt

An elegantly crafted functional API for Laravel Livewire.

4205.3M84](/packages/livewire-volt)[ramonrietdijk/livewire-tables

Dynamic tables for models with Laravel Livewire

21147.4k](/packages/ramonrietdijk-livewire-tables)

PHPackages © 2026

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