When using `@clerk/nextjs/webhooks` with `verifyWebhook(req)` in an API route (`app/api/users/webhook/route.ts`), the build fails on Vercel (Next.js 15.3.4).

[devlopermitesh]

Preliminary Checks

• I have reviewed the documentation: https://clerk.com/docs

• I have searched for existing issues: https://github.com/clerk/javascript/issues

• I have not already reached out to Clerk support via email or Discord (if you have, no need to open an issue here)

• This issue is not a question, general help request, or anything other than a bug report directly related to Clerk. Please ask questions in our Discord community: https://clerk.com/discord.

Reproduction

https://github.com/devlopermitesh/Youtube

Publishable key

pk_test_bmljZS1jb3ctMzIuY2xlcmsuYWNjb3VudHMuZGV2JA

Description

🐛 Bug Report

When using @clerk/nextjs/webhooks with verifyWebhook(req) in an API route (app/api/users/webhook/route.ts), the build fails on Vercel (Next.js 15.3.4).

Even though the route is marked with:

export const dynamic = "force-dynamic";
export const runtime = "edge"; // OR even "nodejs"

TypeError: Cannot read properties of undefined (reading 'query')


### Environment

```Shell
System:
 OS: Windows 11
 CPU: (4) x64 Intel(R) Core(TM) i5-7200U CPU @ 2.50GHz
 Memory: 8 GB RAM
 Binaries:
 Node: 20.12.2
 npm: 10.5.0
 pnpm: 9.1.1
 Browsers:
 Chrome: 137.0.0.0
 Edge: 123.0.0.0
 npmPackages:
 next: 15.3.4
 @clerk/nextjs: 4.0.0
 drizzle-orm: 0.28.2
 @clerk/backend: 4.0.0
 typescript: 5.4.2

[wobsoriano]

Hi there! 👋

I tried to reproduce this issue on my end and had a different experience:

1. Created a new Next.js + Clerk app using the official Clerk + Next quickstart and basically copied the contents of the webhook code from your reproduction
2. Webhook works perfectly with both dev and prod builds locally
3. No build errors encountered during deployment to Vercel

Would you be able to provide more information?

Thanks!

[devlopermitesh]

Hi there! 👋

Thanks for checking and reproducing it on your end!

To help clarify, here's more information about my setup:

• ✅ Framework: Next.js 15.3.4 with App Router
• ✅ Runtime: Using export const runtime = "edge" in the API route
• ✅ Request type: Using NextRequest from next/server (Edge-compatible)
• ✅ Webhook handler: Using verifyWebhook() from @clerk/nextjs/webhooks
• ❌ Error only happens in CI (GitHub Actions) or during next build — not locally

Error Stack

TypeError: Cannot read properties of undefined (reading 'query')
 at new nH (.next/server/app/api/users/webhook/route.js:40:4398)

This points somewhere deep inside the Clerk handler — likely where it expects a .query property on the request, which NextRequest doesn't have (unlike traditional Node.js req objects).

---

Possible Hypothesis:

I suspect the verifyWebhook method may be using req.query, which isn't supported in Edge runtime's NextRequest. That might be why it's working fine in your case (if you’re not using Edge or NextRequest).

---

Would Appreciate Help With:

• Does verifyWebhook() officially support NextRequest (from next/server) in Edge API routes?
• Or should we switch to using the Node.js Request inside /pages/api/ instead?

Let me know if you’d like a minimal reproduction repo — I can set that up too!

Thanks again! 🙏

[wobsoriano]

Thanks again for the detailed info. In the example repo I commented above, it's edge and a copy of the repro you sent. But yes, a minimal repro would make this easier to debug!

I believe we're not using any req.query in our Nextjs codebase. That example is deployed to Vercel and have not experienced any error like that 🤔

For reference:

This is the main backend SDK verifyWebhook function - https://github.com/clerk/javascript/blob/main/packages/backend/src/webhooks.ts

and this is the Nextjs wrapper of that which supports NextRequest and NextApiRequest - https://github.com/clerk/javascript/blob/main/packages/nextjs/src/webhooks.ts

[dre-WildWest]

I'm trying to get vercel + webhooks working so following this closely. My current hangup is

TypeError: svix__WEBPACK_IMPORTED_MODULE_2__.Webhook is not a constructor
 at POST (app/api/users/clerkWebhooks/route.ts:27:48)
 25 | const prisma = new PrismaClient({ datasourceUrl });
 26 |
> 27 | const evt: WebhookEvent = await verifyWebhook(request, {

I've tried with an option and no option passed into verifyWebhook
signingSecret: process.env.CLERK_WEBHOOK_SIGNING_SECRET,

I know it's unrelated but does this sound familiar to you?

[wobsoriano]

Do you have svix installed? The current versions of @clerk/nextjs had svix dependency removed, and we're working on some improvements around webhook verification.

What's your actual @clerk/nextjs version? In the environment info you attached it says 4.0.0 and that's still in Clerk Core 1 but your reproduction repo uses latest version

[dre-WildWest]

Do you have svix installed? The current versions of @clerk/nextjs had svix dependency removed, and we're working on some improvements around webhook verification.

What's your actual @clerk/nextjs version? In the environment info you attached it says 4.0.0 and that's still in Clerk Core 1 but your reproduction repo uses latest version

I was about to update my answer, I was able to get the request verified when I ran npm install svix but I thought it was strange there was no dependency for this in the lock file https://github.com/wobsoriano/clerk-nextjs-webhooks/blob/main/package-lock.json

My current version is "6.17.0". I think you might be confusing my comment with the person who started this thread. Two unrelated inquiries but I thought they might be related

[wobsoriano]

I think you might be confusing my comment with the person who started this thread

Yep 🤦🏼

My current version is "6.17.0"

We removed the svix dependency since 6.21.0 😄 Before that, you'd need to install svix