convex-http-actions

Build HTTP endpoints and webhook handlers in Convex applications.

Updated Nov 2, 2025
One-click install
npx skills add https://github.com/cpmappstudio/cpca-sports --skill convex-http-actions-cpmappstudio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-http-actions
Source: https://github.com/cpmappstudio/cpca-sports/tree/main/.agents/skills/convex-http-actions
Command: npx skills add https://github.com/cpmappstudio/cpca-sports --skill convex-http-actions-cpmappstudio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables developers to quickly build HTTP endpoints, route requests, and handle webhooks within Convex apps, simplifying integration with external APIs and services.

Core Features & Use Cases

  • HTTP endpoint routing and request/response handling
  • Webhook processing with signature verification and authentication
  • CORS configuration, form data, and file upload support
  • Use Case: Build a lightweight API gateway for events from third-party services and routing to Convex mutations/queries

Quick Start

Create a Convex HTTP router with a /health endpoint that returns a JSON status.

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 and webhooks in a Convex app?

To create HTTP endpoints and webhooks in a Convex app, use the Convex httpRouter and httpAction to define custom routes, parse request bodies, and route external events to mutations or queries.

How does webhook signature verification work with Convex HTTP actions?

Webhook signature verification in Convex HTTP actions involves parsing incoming request headers and payloads to authenticate external services before routing the event data to internal Convex mutations or queries.

Can I handle file uploads and form data with Convex HTTP routes?

Yes, Convex HTTP routes can handle file uploads and form data by using httpAction to parse the incoming request body, headers, and URL parameters within your custom API endpoint logic.

How do I configure CORS for custom API endpoints in Convex?

Configure CORS for Convex API endpoints by setting the appropriate HTTP response headers within your httpAction, allowing your custom routes to securely accept cross-origin requests from external web applications.

What is the best way to process third-party API events in Convex?

The best way to process third-party API events in Convex is building a lightweight API gateway using HTTP endpoints to receive webhooks, verify signatures, and forward the event data to Convex mutations.

Why is my Convex HTTP action returning an error when parsing the request body?

Convex HTTP action body parsing errors usually occur due to incorrect request handling logic, requiring proper error handling and validation of URL params, headers, and body formats within the httpRouter setup.