convex-http-actions

Define HTTP routes and webhook handlers in Convex applications using httpRouter and httpAction.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/mmtftr/bakathon --skill convex-http-actions-mmtftr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-http-actions
Source: https://github.com/mmtftr/bakathon/tree/main/.opencode/skills/convex-http-actions
Command: npx skills add https://github.com/mmtftr/bakathon --skill convex-http-actions-mmtftr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convex HTTP Actions provides a cohesive framework to build HTTP endpoints inside Convex applications for webhooks, API integrations, and custom routes, including request/response handling, authentication, CORS, and webhook signature verification.

Core Features & Use Cases

  • Define HTTP routes (GET, POST, etc) in Convex using httpRouter and httpAction.
  • Handle webhooks from common services (Stripe, GitHub, Clerk) with signature validation and secure processing.
  • Support CORS, path parameters, form data, file uploads, and API key or Bearer authentication.
  • Integrate with internal Convex mutations and queries to implement end-to-end workflows.

Quick Start

Configure an HTTP router, define a route such as /webhooks/stripe, and implement a httpAction that validates signatures before processing.

Frequently Asked Questions about convex-http-actions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I handle webhooks in Convex and verify signatures from external services?

To handle webhooks in Convex, define HTTP routes using httpRouter and implement httpAction handlers that validate webhook signatures from services like Stripe or GitHub before securely processing incoming requests.

Can I build custom API routes with authentication inside a Convex application?

Yes, you can build custom API routes in Convex using httpRouter, applying Bearer or API key authentication checks within httpAction handlers to secure your endpoints and integrate with external services.

What's the best way to process HTTP requests and integrate external APIs with Convex mutations?

The best way to integrate external APIs is by using Convex HTTP actions to parse incoming requests, validate authentication, and route the data to internal Convex mutations and queries for end-to-end workflow execution.

Does Convex support CORS, file uploads, and path parameters for HTTP endpoints?

Yes, Convex HTTP endpoints support configuring CORS, extracting path parameters, and processing form data alongside file uploads, allowing flexible request handling within your httpAction handlers.

When do I need to use httpAction instead of standard queries and mutations in Convex?

You need to use httpAction instead of standard queries and mutations when processing incoming HTTP requests from external services, handling webhooks, or building custom API routes that require request and response management.

Why are my Convex HTTP routing configurations not working for external webhook integrations?

Convex HTTP routing issues often stem from incorrectly configured httpRouter paths, missing authentication checks, or unverified webhook signatures, which must be validated inside the httpAction before processing.