Bolt api

Webhook Not Receiving Requests - Events Not Triggered

You've registered a webhook URL but never receive requests from the service (Stripe, GitHub, etc.). The webhook endpoint is never called.

The service shows 'failed delivery' or 'pending' status.

Error Messages You Might See

Webhook delivery failed - timeout Webhook returned 401 Unauthorized Endpoint not reachable Connection refused to webhook URL
Webhook delivery failed - timeoutWebhook returned 401 UnauthorizedEndpoint not reachableConnection refused to webhook URL

Common Causes

  1. Webhook URL not publicly accessible or behind authentication
  2. Webhook endpoint returns error status code (not 200-299)
  3. URL has typo or wrong path
  4. Service can't reach your domain (firewall, development environment)
  5. Webhook signature validation failing, returning 401

How to Fix It

Test webhook URL is publicly accessible: curl https://your-domain.com/api/webhooks/stripe

Endpoint must return 200 status immediately: return NextResponse.json({ ok: true })

Disable signature verification temporarily to test if webhook reaches endpoint

Check webhook delivery logs in service dashboard (Stripe has 'Event' logs)

Ensure endpoint doesn't require authentication (no auth cookie checks)

Real developers can help you.

Anthony Akpan Anthony Akpan Developer with 8 years of experience building softwares fro startups Prakash Prajapati Prakash Prajapati I’m a Senior Python Developer specializing in building secure, scalable, and highly available systems. I work primarily with Python, Django, FastAPI, Docker, PostgreSQL, and modern AI tooling such as PydanticAI, focusing on clean architecture, strong design principles, and reliable DevOps practices. I enjoy solving complex engineering problems and designing systems that are maintainable, resilient, and built to scale. Matthew Butler Matthew Butler Systems Development Engineer @ Amazon Web Services David Olverson David Olverson Solo dev shipping production apps with AI-assisted development. I specialize in rescuing broken Lovable/Bolt/Cursor builds and taking them to production. 10+ apps shipped including SaaS CRMs, gaming platforms, real estate tools, and Discord bots. Stack: Next.js 16, TypeScript, Tailwind CSS, FastAPI, PostgreSQL, Prisma. I use Claude Code with 50+ custom skills for rapid delivery. Average turnaround: 2-4 weeks from broken prototype to production. AUXLE AUXLE I am a Full Stack Developer experienced in building Websites, Web apps and Cross Platform Mobile Apps for Startups and Companies. Omar Faruk Omar Faruk As a Product Engineer at Klasio, I contributed to end-to-end product development, focusing on scalability, performance, and user experience. My work spanned building and refining core features, developing dynamic website templates, integrating secure and reliable payment gateways, and optimizing the overall system architecture. I played a key role in creating a scalable and maintainable platform to support educators and learners globally. I'm enthusiastic about embracing new challenges and making meaningful contributions. Krishna Sai Kuncha Krishna Sai Kuncha Experienced Professional Full stack Developer with 8+ years of experience across react, python, js, ts, golang and react-native. Developed inhouse websearch tooling for AI before websearch was solved : ) Stanislav Prigodich Stanislav Prigodich 15+ years building iOS and web apps at startups and enterprise companies. I want to use that experience to help builders ship real products - when something breaks, I'm here to fix it. Victor Denisov Victor Denisov Developer Tejas Chokhawala Tejas Chokhawala Full-stack engineer with 5 years experience building production web apps using React, Next.js and TypeScript. Focused on performance, clean architecture and shipping fast. Experienced with Supabase/Postgres backends, Stripe billing, and building AI-assisted developer tools.

You don't need to be technical. Just describe what's wrong and a verified developer will handle the rest.

Get Help

Frequently Asked Questions

How do I test webhooks locally?

Use ngrok: ngrok http 3000, then use ngrok URL for webhook. Or use Stripe CLI for Stripe webhooks

Why would webhook reach endpoint but validation fail?

Signature verification failing. Check secret key matches, verify timestamp isn't expired (usually 5min tolerance)

Should I process webhook synchronously?

No! Return 200 immediately, process async. Webhook services timeout after ~30s

Related Bolt Issues

Can't fix it yourself?
Real developers can help.

You don't need to be technical. Just describe what's wrong and a verified developer will handle the rest.

Get Help