ESP setup
SendGrid — add and edit
Create an InboxMon card, paste the webhook into SendGrid Event Webhook, then edit that URL if the token or app host changes.
InboxMon does not send campaigns. You send with the ESP. InboxMon only receives events on the webhook URL for that connection.
Add the connection in InboxMon
- Sign in → Settings → ESP connections.
- Provider: SendGrid. Sending domain: the From domain (no
www, no@). - Optional: DKIM selectors now, or save them later on the card.
- Add connection. Copy the webhook URL (includes
?token=). Paste the whole string.
One card per ESP + sending domain. Each extra Add click creates a new URL. Only the URL you paste into the ESP will show Last event.
Add the webhook in SendGrid
- Authenticate the sending domain: Settings → Sender Authentication → Authenticate Your Domain. Wait until Verified.
- Open Settings → Mail Settings → Event Webhook (or For Developers → Webhooks). UI names vary.
- HTTP POST URL = the copied InboxMon URL.
- Enable at least: Processed, Delivered, Bounce / Blocked / Dropped, Deferred, Spam Report, Unsubscribe / Group Unsubscribe. Open / Click if you want engagement on Overview.
- Leave batch on if SendGrid offers it. InboxMon accepts a JSON array.
- Save. Use Test Your Integration if present, then send a real message From that domain.
Edit the connection in InboxMon
You cannot rename the provider or sending domain on an existing card. Use the card controls:
- Copy — same webhook URL. Use this when you need to paste it again into the ESP.
- Disable — InboxMon stops ingesting. The ESP may still POST; those requests are skipped. Use this for unused duplicate cards.
- Enable — ingest resumes on the same URL. You do not get a new token.
- DKIM selectors → Save selectors — for the Domains watchdog only, not for webhook ingest. Gray placeholder text is not stored until you save.
- Sync ESP data / Sync now — re-runs DNS and anomaly detection on events already stored. It does not pull history from the ESP.
To change the sending domain, add a new connection, point the ESP at the new URL, then Disable the old card.
Edit the webhook in SendGrid
Change the InboxMon URL
- InboxMon → copy the URL from the existing card (do not Add again unless you want a new URL).
- SendGrid → Event Webhook → paste the new URL → Save.
- Send a test. Last event should update on that same card.
Turn events off without deleting InboxMon
Disable the Event Webhook in SendGrid, or Disable the InboxMon card. Either stops new dashboard data. Disable unused extra InboxMon cards so you are not looking at empty listeners.
Wrong or duplicate cards
If you clicked Add connection more than once, only the URL currently saved in SendGrid receives events. Disable the extras.
Confirm it works
Send a real message. Within about 30 seconds the card should show Last event, then Overview and Events fill in. Keep the webhook URL private. Requests without a matching token return 401. A full monthly event cap returns 429.
If Last event stays empty
- This card’s URL is in SendGrid (not a sibling SES/Postmark card).
- Connection badge is active.
- Event Webhook is enabled and a real send happened (saving the URL does not create events).