convex-http-actions

Expose Convex actions and queries via HTTP endpoints and webhooks.

Updated Dec 25, 2025
One-click install
npx skills add https://github.com/benfwalla/things-to-be-happy-about --skill convex-http-actions-benfwalla
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-http-actions
Source: https://github.com/benfwalla/things-to-be-happy-about/tree/main/.claude/skills/convex-http-actions
Command: npx skills add https://github.com/benfwalla/things-to-be-happy-about --skill convex-http-actions-benfwalla

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Expose Convex-backed logic to external systems via HTTP endpoints and webhooks, enabling seamless integration with external services while preserving Convex data integrity and access controls.

Core Features & Use Cases

  • Define HTTP routes and handlers that call Convex actions and queries
  • Receive, verify, and process webhooks from external services
  • Manage authentication, CORS, and request validation for secure, browser-accessible endpoints
  • Integrate with Convex internal mutations and queries for end-to-end workflows

Quick Start

Define an HTTP route and a webhook endpoint in your Convex app, then deploy.

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 Convex logic to external systems via HTTP endpoints?

You can expose Convex logic to external systems by defining HTTP routes and handlers that call Convex actions and queries. This allows external services to interact directly with your Convex backend through standard HTTP requests.

How do I receive and verify webhooks in a Convex application?

To receive webhooks in a Convex application, define an HTTP route and a webhook endpoint. The system provides request handling, signature validation, and end-to-end workflow coordination using Convex actions to process incoming webhook payloads securely.

Can I manage CORS and authentication for browser-accessible Convex endpoints?

Yes, you can manage CORS and authentication for browser-accessible endpoints. The system handles request validation and secure authentication alongside CORS management to ensure your exposed HTTP endpoints remain protected.

How do I integrate Convex internal mutations with external HTTP requests?

Integrate Convex internal mutations with external HTTP requests by using Convex actions. Actions provide the routing and end-to-end workflow coordination needed to pass validated HTTP request data directly into your internal mutations and queries.

Do I need Convex actions to handle API endpoints and webhooks?

Yes, Convex actions are required to handle API endpoints and webhooks. Actions provide the necessary HTTP routing, request/response handling, and signature validation to coordinate workflows between external services and internal mutations.

What's the best way to route external webhooks to Convex queries?

The best way to route external webhooks to Convex queries is by defining dedicated HTTP routes that trigger Convex actions. Actions validate signatures and coordinate the end-to-end workflow, passing data securely into internal queries.