convex-http-actions

Expose HTTP endpoints for Convex applications using httpRouter.

23|5|Updated Nov 5, 2025
One-click install
npx skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite --skill convex-http-actions-jstarfilms
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-http-actions
Source: https://github.com/JStaRFilms/VibeCode-Protocol-Suite/tree/main/assets/.agent/skills/convex-http-actions
Command: npx skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite --skill convex-http-actions-jstarfilms

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enables Convex apps to expose HTTP endpoints, route requests, and securely integrate with external APIs and webhooks without leaving the Convex environment.

Core Features & Use Cases

  • Define HTTP routes and endpoints using Convex HTTP router for handling GET, POST, and other methods.
  • Implement webhook reception, request parsing (JSON, form data, raw bytes), and external API calls with authentication, CORS, and signature verification.
  • Use cases include webhook processing, API gateways, and lightweight integrations for Convex-powered backends.

Quick Start

Initialize a Convex HTTP action endpoint and test a sample webhook to confirm routing and security.

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 webhooks?

Create HTTP endpoints in Convex using the httpRouter to define routes for handling GET and POST requests. This enables your application to securely receive webhooks and parse JSON or form data payloads from external services.

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

Yes, you can configure CORS for HTTP routes in a Convex application. The Skill implements HTTP route definitions that support CORS configuration, allowing secure cross-origin requests to your exposed RESTful endpoints.

How does webhook signature verification work with Convex HTTP actions?

Webhook signature verification in Convex HTTP actions validates incoming requests by checking cryptographic signatures. This ensures that webhook payloads received on your HTTP endpoints are authentic and securely integrated from external APIs.

What is the best way to build an API gateway in Convex?

The best way to build an API gateway in Convex is using the httpRouter to expose HTTP endpoints. This approach handles request parsing, implements authentication checks, and securely integrates external services without leaving the Convex environment.

Does Convex support parsing raw bytes and form data in HTTP endpoints?

Yes, Convex supports parsing raw bytes and form data in HTTP endpoints. The HTTP action endpoints can handle JSON, form data, and raw bytes, providing flexible request parsing for various webhook and API integration scenarios.

When do I need to use HTTP actions instead of standard Convex queries?

You need HTTP actions when integrating external services that require RESTful endpoints, webhook reception, or API gateway functionality. Standard Convex queries handle internal data operations, while HTTP actions expose secure external routes for incoming requests.