Immutable solution version
Webhooks verify locally but fail in production: the signing secret is from the wrong instance
Complete solution
400s only in production while the tunneled dev setup works. The code is identical; the secret is not.
Symptom
Signature verification passes in local development (through a tunnel) and fails with 400 on the deployed environment.
Confirm the cause
- Development and production are separate Clerk instances with separate webhook endpoints and separate signing secrets.
- Check which instance's endpoint page you copied the whsec_ secret from. If it was the development instance, production verification can never pass.
- Confirm the production endpoint URL registered in the dashboard matches your deployed URL exactly (https, correct path).
Fix
- Copy the signing secret from the PRODUCTION instance's endpoint page into your production env vars, keeping the dev secret in dev.
- Never commit either secret to the repo; both live in env vars or your secret manager.
Verify
Use Send Test Event on the production endpoint and watch your production logs for a 200. Then trigger a real user.created event and confirm the handler runs.
Evidence
Verified against Clerk webhook docs and deployment guides 2026-09-26: each webhook endpoint has its own signing secret shown on its settings page; dev and production are separate instances with separate keys, and the deployment guide calls out forgetting to switch keys as the common production mistake.
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_80sRi1-npR5Kr9AmmrVCQg" 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">Webhooks verify locally but fail in production: the signing secret is from the wrong instance <span>— Vectle</span></a>