convex-http-actions

Define HTTP routes and handle webhooks in Convex applications.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/qdhenry/Foundry-OSS --skill convex-http-actions-qdhenry
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-http-actions
Source: https://github.com/qdhenry/Foundry-OSS/tree/main/.agents/skills/convex-http-actions
Command: npx skills add https://github.com/qdhenry/Foundry-OSS --skill convex-http-actions-qdhenry

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convex apps require a reliable way to expose HTTP endpoints and process webhooks from external services. This Skill provides a framework to define routes, handle requests, enforce authentication, and configure CORS within Convex.

Core Features & Use Cases

  • Define HTTP routes and endpoints across Convex servers
  • Handle webhooks, request bodies, and URL parameters securely
  • Support authentication, CORS, and flexible response generation for API integrations
  • Use Case: Connect external services (e.g., Stripe, GitHub) to trigger Convex mutations or queries based on events

Quick Start

Create an HTTP router with a /health endpoint to verify the service is running.

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 for external API integrations?

You build HTTP endpoints in Convex by defining routes via the convex/server module and handling requests with httpAction, which supports request parsing, path parameters, and flexible response generation for external integrations.

How do I handle webhooks from services like Stripe in a Convex application?

Handling webhooks in Convex involves defining HTTP routes that securely parse incoming request bodies and URL parameters, triggering internal mutations or queries based on external service events like Stripe or GitHub.

Can I configure CORS and authentication for Convex HTTP routes?

Yes, you can configure CORS and enforce authentication for Convex HTTP routes to secure webhook handlers and API integrations, ensuring safe request processing and flexible response generation across external services.

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

Yes, Convex HTTP actions support file uploads, request body parsing, and URL path parameters, enabling robust API integrations and webhook processing alongside comprehensive error handling and response generation.

What is the best way to structure error handling for HTTP endpoints in Convex?

Structured error handling in Convex HTTP endpoints is managed within the httpAction handler, ensuring webhook routes and API integrations return appropriate error responses when request parsing, authentication, or file upload processing fails.