convex-http-actions

Define and expose HTTP endpoints in Convex for webhooks and API calls.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convex applications often need secure, scalable HTTP endpoints for webhooks, external API calls, and custom routes, and this Skill provides a structured approach to define, route, and protect those endpoints without leaking internal logic.

Core Features & Use Cases

  • Define HTTP endpoints with httpRouter and httpAction for GET/POST/etc.
  • Handle CORS, authentication, and webhook signature verification for secure integrations with external services.
  • Build webhook handlers for Stripe, GitHub, Clerk, and other providers, plus support for file uploads and form data.

Quick Start

Define a basic GET health endpoint and test it end-to-end to verify HTTP actions work.

Frequently Asked Questions about convex-http-actions

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

FAQPage Schema
How do I expose HTTP endpoints in Convex for webhook handling?

You expose HTTP endpoints in Convex by using httpRouter and httpAction to define GET or POST routes. This approach allows your application to securely receive webhooks and perform external API calls without exposing internal logic.

Can I verify webhook signatures and configure CORS for external service integrations in Convex?

Yes, you can configure CORS and verify webhook signatures within your Convex HTTP actions. This ensures secure integrations with external services like Stripe or GitHub by validating request authenticity before processing payloads.

Does this approach support handling file uploads and form data in Convex HTTP routes?

Yes, building HTTP endpoints with httpAction in Convex supports processing file uploads and form data. This allows your custom routes to securely accept and handle varied payload types from external clients.

What is the best way to structure custom routes and authenticate API calls in Convex?

The best way to structure custom routes in Convex is using httpRouter to map paths to httpAction handlers. You apply authentication within these actions to safely interact with internal Convex logic and external APIs.

Why should I use Convex HTTP actions instead of direct database access for external requests?

Convex HTTP actions provide a structured, secure boundary for receiving webhooks and external API calls. They prevent leaking internal logic by handling routing, error management, and authentication before touching the database.