Centro de Ayuda
API

API de HiveFlow

Autentícate con JWT o API keys, dispara flows por HTTP y explora la referencia OpenAPI completa en Apidog, Swagger UI o Redoc.

Todo lo que hace el dashboard pasa por la API REST de HiveFlow (https://api.hiveflow.ai/api), y puedes usarla directamente: disparar flows desde tus sistemas, gestionar recursos programáticamente, o construir sobre la plataforma.

Analytics — las ejecuciones disparadas por API también cuentan

Autenticación

MétodoCaso de uso
Bearer token (JWT)Sesiones web — se obtiene al iniciar sesión.
API keysServidor a servidor — créalas en Perfil → API Keys y envíalas con tus requests.
Llaves de triggerCada nodo HTTP trigger tiene su propia llave embebida en la URL del webhook.

Dispara un flow por HTTP

Agrega un nodo Trigger (o Flow Input) a tu flow, copia su URL de webhook y llámala:

curl -X POST "https://api.hiveflow.ai/api/triggers/flow/<flowId>/<apiKey>" \
  -H "Content-Type: application/json" \
  -d '{"message": "Nuevo pedido #1234"}'

El payload se vuelve la entrada del flow; la respuesta contiene la salida del flow. Este es también el mecanismo que usan las Hive Apps para llamar a su flow vinculado.

Referencia completa (Apidog / OpenAPI)

La referencia completa — auth, flows, nodos, ejecuciones, agents, Hive Apps, skills, WhatsApp, MCP y más (126 endpoints) — se mantiene como spec OpenAPI 3.0 generada desde el código. La gestionamos en Apidog, y puedes consumirla en el formato que prefieras:

  • Spec en vivo: GET https://api.hiveflow.ai/api-docs-json — importa esta URL directo en Apidog, Postman o cualquier herramienta OpenAPI.
  • Swagger UI: https://api.hiveflow.ai/api-docs
  • Redoc: https://api.hiveflow.ai/docs/redoc

Grupos principales de tags: Autenticación, API Keys, Flujos, Nodos, Conexiones, Procesamiento, LLM, Triggers, WhatsApp, MCP, Extension.

Créditos y límites

Las ejecuciones disparadas por API consumen los mismos créditos y respetan los mismos límites de plan que el dashboard. Los endpoints públicos tienen rate limit por IP/llave.

En esta página