convex-http-actions

Define HTTP endpoints and webhook handlers for Convex applications.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convex HTTP Actions solves the problem of building and wiring HTTP endpoints, webhook handlers, and external API integrations inside Convex applications, providing a structured approach to routing, authentication, and security.

Core Features & Use Cases

  • Define HTTP endpoints using convex/http.ts, httpRouter, and httpAction to expose REST-like routes inside a Convex app.
  • Handle webhooks and external service callbacks with signature verification, request parsing, CORS configuration, and reliable error handling.
  • Support common API patterns including authentication (API keys and Bearer tokens), path and query parameter extraction, and file uploads.

Quick Start

Create an httpRouter, define routes with httpAction handlers, and wire up authentication, CORS, and webhook verification as shown in the examples.

Frequently Asked Questions about convex-http-actions

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

FAQPage Schema
How do I set up HTTP endpoints and webhooks in a Convex application?

You define HTTP endpoints in a Convex application by creating an httpRouter in convex/http.ts, using httpAction handlers to map routes, and wiring up webhook verification, CORS, and authentication logic.

What is the best way to handle API authentication for Convex HTTP actions?

Handling API authentication for Convex HTTP actions involves validating API keys or Bearer tokens inside your httpAction handlers to ensure only authorized external requests can access your endpoints.

Can I configure CORS for external API integrations in Convex?

You can configure CORS for external API integrations in Convex by setting appropriate headers within your httpAction handlers, allowing controlled cross-origin access to your HTTP endpoints.

How do I verify webhook signatures when using Convex httpRouter?

Verifying webhook signatures with Convex httpRouter requires parsing the incoming request in your httpAction and applying signature validation to confirm the external service callback is authentic before processing.

Does Convex support extracting path parameters and file uploads in HTTP actions?

Convex supports extracting path and query parameters alongside handling file uploads within HTTP actions, enabling you to build REST-like routes that process diverse external request payloads.