PHPackages                             kitbrennan90/laravel-sendgrid-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. kitbrennan90/laravel-sendgrid-webhooks

ActiveLibrary

kitbrennan90/laravel-sendgrid-webhooks
======================================

Laravel package for receiving and storing event webhooks from Sendgrid

1.1.1(6y ago)63.9k11[4 issues](https://github.com/kitbrennan90/laravel-sendgrid-webhooks/issues)[1 PRs](https://github.com/kitbrennan90/laravel-sendgrid-webhooks/pulls)MITPHPPHP >=7.0CI failing

Since Apr 16Pushed 5y ago1 watchersCompare

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

READMEChangelogDependencies (4)Versions (6)Used By (0)

Laravel Sendgrid Webhooks
=========================

[](#laravel-sendgrid-webhooks)

This package enables your Laravel application to receive event webhooks from Sendgrid, and will automatically store those webhooks in your database. The package also fires Laravel events so you can hook in to the webhooks and take your own actions.

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

[](#installation)

### Getting the package

[](#getting-the-package)

The best way to install this package is with composer. Run this from your command line:

```
composer require kitbrennan90/laravel-sendgrid-webhooks ~1.0
```

### Run the migrations

[](#run-the-migrations)

This package will create a table called `sendgrid_webhook_events` which will be used to store all the Sendgrid webhooks received.

Once you have included the package, this migration will run automatically with your normal migrations, so just call:

```
php artisan migrate
```

### Copy the config file (optional)

[](#copy-the-config-file-optional)

This library works without any local configuration, however you may want to use the config file in order to tweak the logs you receive (eg. to receive logs when you receive duplicate events).

Call the command below to copy the package config files:

```
php artisan vendor:publish --provider="LaravelSendgridWebhooks\ServiceProvider"
```

### Tell Sendgrid to use your new event webhook URL

[](#tell-sendgrid-to-use-your-new-event-webhook-url)

Head over to [https://app.sendgrid.com/settings/mail\_settings](https://app.sendgrid.com/settings/mail_settings) and click on the 'Event Notification' section.

Your HTTP Post URL is: `https://yourwebsite.com/sendgrid/webhook`

Using the library
-----------------

[](#using-the-library)

### Querying records

[](#querying-records)

This library uses a standard Laravel Eloquent model, so you can therefore query it as you would any other model.

```
// Include the class
use \LaravelSendgridWebhooks\Models\SendgridWebhookEvent;

////////////////////

// Get all records:
SendgridWebhookEvent::all();

// Get all by message ID:
$sendgridMessageId = 'abc123';
SendgridWebhookEvent::where('sg_message_id', $sendgridMessageId)->all();

// Get all by event ID:
$sendgridEventId = 'xyz987';
SendgridWebhookEvent::where('sg_event_id', $sendgridEventId)->all();

// Get all by event type
SendgridWebhookEvent::where('event', LaravelSendgridWebhooks\Enums::PROCESSED)->all();
SendgridWebhookEvent::where('event', LaravelSendgridWebhooks\Enums::DEFERRED)->all();
SendgridWebhookEvent::where('event', LaravelSendgridWebhooks\Enums::DELIVERED)->all();
SendgridWebhookEvent::where('event', LaravelSendgridWebhooks\Enums::OPEN)->all();
SendgridWebhookEvent::where('event', LaravelSendgridWebhooks\Enums::CLICK)->all();
SendgridWebhookEvent::where('event', LaravelSendgridWebhooks\Enums::BOUNCE)->all();
SendgridWebhookEvent::where('event', LaravelSendgridWebhooks\Enums::DROPPED)->all();
SendgridWebhookEvent::where('event', LaravelSendgridWebhooks\Enums::SPAMREPORT)->all();
SendgridWebhookEvent::where('event', LaravelSendgridWebhooks\Enums::UNSUBSCRIBE)->all();
SendgridWebhookEvent::where('event', LaravelSendgridWebhooks\Enums::GROUP_UNSUBSCRIBE)->all();
SendgridWebhookEvent::where('event', LaravelSendgridWebhooks\Enums::GROUP_RESUBSCRIBE)->all();

// Count all bounces
SendgridWebhookEvent::where('event', LaravelSendgridWebhooks\Enums::BOUNCE)->count();
```

### Interacting with a record

[](#interacting-with-a-record)

Accessing data included with all event types:

```
// Get a record
$event = SendgridWebhookEvent::first();

// Included with all event types
$event->timestamp;
$event->email;
$event->event;
$event->categories;
$event->sg_event_id;
$event->sg_message_id;
$event->payload; // Array of full payload sent by Sendgrid
```

Some data is only included with specific events. You can find out what these attributes are here: [https://sendgrid.com/docs/API\_Reference/Event\_Webhook/event.html#-Event-objects](https://sendgrid.com/docs/API_Reference/Event_Webhook/event.html#-Event-objects)

We include this data under the payload array within a record. For example:

```
// Get a record
$event = SendgridWebhookEvent::first();

// Access the reason attribute, included on 'dropped' and 'bounced' events.
$event->payload['reason'];
```

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance7

Infrequent updates — may be unmaintained

Popularity28

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 86.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 ~9 days

Total

5

Last Release

2546d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b20b074813a9caaa48ad142152597051abe161caffc4d1182f967a35eb6409e4?d=identicon)[kitbrennan](/maintainers/kitbrennan)

---

Top Contributors

[![kitbrennan90](https://avatars.githubusercontent.com/u/1593605?v=4)](https://github.com/kitbrennan90 "kitbrennan90 (13 commits)")[![mrobles-cedesa](https://avatars.githubusercontent.com/u/25462594?v=4)](https://github.com/mrobles-cedesa "mrobles-cedesa (1 commits)")[![Orclyx](https://avatars.githubusercontent.com/u/1742238?v=4)](https://github.com/Orclyx "Orclyx (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[mettle/sendportal-core

Sendportal core functionality.

30033.9k1](/packages/mettle-sendportal-core)[swiftmade/laravel-sendgrid-notification-channel

Laravel Notification Channel for Sengrid.com

26287.7k](/packages/swiftmade-laravel-sendgrid-notification-channel)[iandenh/cakephp-sendgrid

SendgridEmail plugin for CakePHP

16123.4k](/packages/iandenh-cakephp-sendgrid)[bryglen/yii2-sendgrid

Sendgrid Mailer for Yii 2

1353.5k](/packages/bryglen-yii2-sendgrid)

PHPackages © 2026

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