convex-http-actions

Expose HTTP endpoints for Convex apps with routing, authentication, and webhook verification.

1|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/lulacoder/Hotel_management --skill convex-http-actions-lulacoder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-http-actions
Source: https://github.com/lulacoder/Hotel_management/tree/main/.opencode/skills/convex-http-actions
Command: npx skills add https://github.com/lulacoder/Hotel_management --skill convex-http-actions-lulacoder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convex apps need reliable, secure HTTP endpoints to receive webhooks, integrate with external services, and expose custom routes. This Skill provides a structured approach to implement HTTP actions, including routing, request handling, authentication, CORS, and webhook verification.

Core Features & Use Cases

  • HTTP endpoint routing: Define paths and methods to handle GET/POST requests.
  • Webhook handling: Validate signatures and process incoming events from services like Stripe, GitHub, Clerk, or others.
  • Authentication & Security: Enforce API keys or Bearer tokens to protect endpoints.
  • Examples: Build a /webhooks/ endpoint for Stripe to verify signatures, or a /api/items route to create and list resources.

Quick Start

  1. Create an HTTP router using convex/http.ts, define routes with httpRouter().route({ path, method, handler: httpAction(async (ctx, request) => { ... }) }).
  2. Implement route handlers to parse JSON or form data, access headers, and respond with JSON.
  3. Add webhook verification and storage interactions via internal actions, and test with sample payloads.

Frequently Asked Questions about convex-http-actions

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

FAQPage Schema
How do I create HTTP endpoints in Convex to receive external webhooks?

Create HTTP endpoints in Convex by defining paths and methods in the `convex/http.ts` file using `httpRouter().route()`. You can then implement `httpAction` handlers to parse incoming JSON requests, validate webhook signatures, and process external events securely.

Can I configure CORS for HTTP routes in my Convex application?

Yes, you can configure CORS for HTTP routes in your Convex application. When defining your HTTP actions, you can apply CORS configurations to ensure your endpoints securely accept cross-origin requests from external clients and web applications.

How do I verify Stripe webhook signatures in a Convex backend?

Verify Stripe webhook signatures in a Convex backend by implementing an HTTP action that extracts the signature from request headers and validates it. The route handler parses the incoming payload and runs internal Convex actions to process verified events.

Does Convex support custom API routes with Bearer token authentication?

Yes, Convex supports custom API routes with Bearer token authentication. You can enforce API keys or Bearer tokens within your `httpAction` handlers to protect your endpoints and ensure only authorized external services can access your routes.

What's the best way to handle GET and POST requests in Convex HTTP actions?

The best way to handle GET and POST requests in Convex HTTP actions is using the `httpRouter` in `convex/http.ts`. You define specific paths and methods, then parse JSON or form data within the `httpAction` to respond dynamically based on the request method.

How do Convex HTTP actions interact with internal queries and mutations?

Convex HTTP actions interact with internal queries and mutations by using the context object provided to the `httpAction` handler. After parsing external requests and verifying signatures, the action can run internal Convex queries or mutations to read and write data.