QStash Signature Verification Failed (Invalid Signature)

How to fix it

// try these in order, the most common fix is first

1. FIX 1Verify the raw body

   Copy steps
   1. 01Read the body as text (await req.text()) before any parsing
   2. 02Pass that exact string to receiver.verify({ signature, body })
   3. 03Parse JSON only after verification passes
   Did this fix it? Yes No

2. FIX 2Use the right signing keys

   Copy steps
   1. 01Upstash Console > QStash > copy Current and Next signing keys
   2. 02Set QSTASH_CURRENT_SIGNING_KEY and QSTASH_NEXT_SIGNING_KEY in the environment
   3. 03Use the SDK Receiver, which checks both keys so rotation doesn't break you
   Did this fix it? Yes No

3. FIX 3Preserve headers through proxies

   Copy steps
   1. 01In Nginx, make sure the Upstash-Signature header is passed to the app
   2. 02Check that no middleware rewrites the body (compression, body parsers)
   Did this fix it? Yes No

4. FIX 4Test end to end

   Copy steps
   1. 01Publish a test message from the Console's request builder
   2. 02Check the QStash logs tab for the response code and body
   Did this fix it? Yes No

Symptoms

Your endpoint returns 401 'Invalid signature' to QStash, messages retry and land in the DLQ, or verifySignature throws in Next.js/Cloudflare Workers.

Why it happens

• C-01Body parsed as JSON then JSON.stringify'd before verifying
• C-02Wrong or outdated QSTASH_CURRENT_SIGNING_KEY / QSTASH_NEXT_SIGNING_KEY
• C-03Reverse proxy (Nginx) drops the Upstash-Signature header
• C-04URL mismatch between the published destination and the verified URL

// this guide also covers

• qstash invalid signature
• qstash signature verification failed
• upstash qstash 401
• qstash receiver verify error

Other Upstash errors

• Upstash ERR Max Requests Limit Exceeded
• Upstash ERR Max Request Size Exceeded
• Upstash Redis ECONNRESET Error
• Upstash WRONGPASS Invalid or Missing Auth Token
• Upstash ERR Max Concurrent Connections Exceeded
• Upstash Free Database Archived or Deleted
• Upstash Redis Slow or Timing Out
• Upstash Ratelimit Not Working