Why use Hookfire with SendGrid?

Instant push notifications

Get notified on your phone the moment a SendGrid webhook fires. No more checking dashboards.

Subscribe to what matters

Choose exactly which SendGrid events trigger notifications. Filter out the noise.

Team-wide delivery

Control who on your team gets notified and how: push notifications, record only, or both.

Setup in under 2 minutes

Copy a webhook URL, paste it in SendGrid, and you're done. No code required.

Supported events

Event	Sample notification
Bounced `bounce` 📭 Email bounced: alex@example.com 500 unknown recipient	📭 Email bounced: alex@example.com 500 unknown recipient
Dropped `dropped` 🚫 Email dropped: alex@example.com SendGrid did not send it - Bounced Address	🚫 Email dropped: alex@example.com SendGrid did not send it - Bounced Address
Spam report `spamreport` 🚨 Spam report from alex@example.com They marked your email as spam and will get no more from you	🚨 Spam report from alex@example.com They marked your email as spam and will get no more from you
Unsubscribed `unsubscribe` 👋 Unsubscribed: alex@example.com They opted out of all your email	👋 Unsubscribed: alex@example.com They opted out of all your email
Unsubscribed from a group `group_unsubscribe` 👋 Unsubscribed from group 10 alex@example.com opted out of that group	👋 Unsubscribed from group 10 alex@example.com opted out of that group
Account status changed `account_status_change` ⛔ SendGrid account status changed Status: compliance_suspend. Check your SendGrid account now.	⛔ SendGrid account status changed Status: compliance_suspend. Check your SendGrid account now.
Delivered `delivered` ✅ Delivered to alex@example.com 250 OK	✅ Delivered to alex@example.com 250 OK

How to connect SendGrid

Step 1: Create an Integration

Go to your organization’s Integrations page.
Click Add Integration and select SendGrid.
You’ll receive a unique Webhook URL. Copy it.

Step 2: Add the Event Webhook in SendGrid

In SendGrid, go to Settings → Mail Settings and open Event Webhooks under Webhook Settings.
Click Create new webhook and paste your Hookfire webhook URL as the Post URL.
Under Actions to be posted, tick only what you want on your phone, for example Bounced, Dropped, Spam Reports and Unsubscribes. SendGrid posts every ticked action, and Delivered or Opened can mean thousands of events a day.
Under Security features, turn on Signed Event Webhook and save.

See SendGrid’s Event Webhook docs.

Step 3: Verification Key

Open the webhook again (cog → Edit) and copy the Verification Key shown under the signed webhook setting. It is a public key, not a password.
Paste it into the Signing Secret field on your Hookfire integration page.

SendGrid signs each batch with an ECDSA signature in the X-Twilio-Email-Event-Webhook-Signature header, and Hookfire refuses anything that does not verify against that key.

Step 4: Subscribe to Events

On your Hookfire integration page, toggle on the events you want to receive push notifications for.

SendGrid sends events in batches. Hookfire splits each batch and notifies you only about the events you switched on, up to 100 per batch.

Step 5: Test

Click Test Your Integration on the webhook in SendGrid after saving it, or click Test next to an event on your Hookfire integration page.

Supported Events

Event	Description
`bounce`	The receiving server rejected the message
`dropped`	SendGrid did not send the message, for example to a suppressed address
`spamreport`	A recipient marked the message as spam
`unsubscribe`	A recipient unsubscribed from all email
`group_unsubscribe`	A recipient unsubscribed from one group
`account_status_change`	Your SendGrid account status changed, for example a compliance suspension
`delivered`	The message was accepted by the receiving server

SendGrid