Connecting
Learn/L9 · Convex in production

HTTP action vs internal action

HTTP actions answer the internet; internal actions are called from mutations or schedulers.

Difficulty 3/5

Plain English

Use HTTP for webhooks with a URL. Use regular actions when only your own code calls OpenRouter/Stripe. Both can call mutations to persist.

Analogy

Front desk (HTTP) vs internal phone extension (action).

Agentify CRM

Webhook httpAction; bot LLM call as action from mutation chain.

Go deeper

URL entry = HTTP.

Common mistakes

  • Callable HTTP without auth on sensitive paths.

AI-agent trap

Mutation with fetch instead of action.

Summary

Same Node capabilities in both when use node.

Confidence: