misaf/laravel-email-webhooks

Core package for handling email webhook events in Laravel applications.

v1.0.1 2026-07-05 21:47 UTC

Requires

• php: ^8.3
• illuminate/support: ^13.0
• spatie/laravel-package-tools: ^1.92
• spatie/laravel-webhook-client: ^3.4.3

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.0
• orchestra/testbench: ^11.0
• pestphp/pest: ^4.0
• pestphp/pest-plugin-arch: ^4.0
• pestphp/pest-plugin-laravel: ^4.0
• pestphp/pest-plugin-profanity: ^4.2.1
• pestphp/pest-plugin-type-coverage: ^4.0.3

MIT

• Ehsan Mahmoodi

• event
• email
• laravel
• integration
• webhook

Published on Packagist.org on 2026-07-05 21:47 UTC

README

Provider-neutral Laravel 13 package for parsing email webhook payloads into DTOs and dispatching Laravel events.

Requirements

• PHP 8.4+
• Laravel 13

Installation

composer require misaf/laravel-email-webhooks

The service provider is auto-discovered by Laravel.

Usage

Create a provider driver by extending Misaf\LaravelEmailWebhooks\EmailWebhooksDriver, then register it with the manager:

use Misaf\LaravelEmailWebhooks\Facades\EmailWebhooks;
use Vendor\Package\ProviderEmailWebhooksDriver;

EmailWebhooks::extend('provider', fn ($app) => $app->make(ProviderEmailWebhooksDriver::class));

Process a validated provider payload through the configured driver:

use Misaf\LaravelEmailWebhooks\Facades\EmailWebhooks;

$eventData = EmailWebhooks::driver('provider')->processEvent($payload);

The package dispatches these Laravel events:

• Misaf\LaravelEmailWebhooks\Events\EmailSent
• Misaf\LaravelEmailWebhooks\Events\EmailBounced
• Misaf\LaravelEmailWebhooks\Events\EmailComplained
• Misaf\LaravelEmailWebhooks\Events\EmailFailed

Testing

composer test