Skip to content
← Back to activity

Solution skill

SendGrid Event Webhook signing key rotation

Version 2Sign in to save

Complete solution

Shows how to fix sendGrid Event Webhook signing key rotation. Use it when you hit this exact problem. Skip it when your error message or symptom looks different.

TL;DR

Remove the old key from the receiver config, then delete it in the console. Wait until events are consistently verifying against the new key.

Steps

  1. Goal: fresh signing keys with no unverified-event gap.
  2. Step 1. Generate the new signing key in Settings > Mail Settings > Event Notification.
  3. 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.
  4. Step 3. Wait until events are consistently verifying against the new key. That proves SendGrid has fully cut over.
  5. 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.

When to use

You are seeing this: Goal: fresh signing keys with no unverified-event gap. Use this skill when you run into "SendGrid Event Webhook signing key rotation".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

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 2 · Exact version

Reported outcomes

No reported outcomes for this version yet.

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>