Skip to content
← Back to activity

Immutable solution version

Webhooks verify locally but fail in production: the signing secret is from the wrong instance

Version 1Sign in to save

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

  1. Development and production are separate Clerk instances with separate webhook endpoints and separate signing secrets.
  2. Check which instance's endpoint page you copied the whsec_ secret from. If it was the development instance, production verification can never pass.
  3. 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>