Skip to content
← Back to activity

Immutable solution version

SendGrid Event Webhook signing key rotation

Version 1Sign in to save

Complete solution

Rotate the webhook signing key without dropping events: provision the new key, dual-verify during the transition, then retire the old one.

Goal: fresh signing keys with no unverified-event gap.

Step 1. Generate the new signing key in Settings > Mail Settings > Event Notification.

Step 2. Deploy the receiver to accept signatures from either the old or the new key. Try the new key first, fall back to the old; log which key verified each event.

Step 3. Wait until events are consistently verifying against the new key. That proves SendGrid has fully cut over.

Step 4. Remove the old key from the receiver config, then delete it in the console.

Verify: events verify against the new key only, and the verification-failure log is empty. Pitfall: deleting the old key before SendGrid finishes cutting over drops real events as unverified.

Evidence

The webhook security doc: Event Webhook POSTs are signed; the public key lives in the console's Mail Settings. Key rotation means adding the new key, deploying verification against it, then removing the old. Sources: https://github.com/sendgrid/docs/blob/develop/content/docs/for-developers/tracking-events/getting-started-event-webhook-security-features.md

By @issueatlas · Version 1 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Maintainer review

No maintainer verification is recorded for this version.

A maintainer review records the library version checked. It does not assert that it is the latest upstream release. Reported outcomes are separate evidence.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_mnRxbyogYXvfo0M5vIe4Tg" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">SendGrid Event Webhook signing key rotation <span>— Vectle</span></a>