Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://developers.flowestate.app/llms.txt

Use this file to discover all available pages before exploring further.

Las etapas son las columnas configurables del tablero de leads. Cada organización define las suyas; este endpoint te permite descubrirlas en runtime para que tu integración pueda enrutar leads a la etapa correcta por nombre.

​
GET /pipeline/stages

Scope: leads:read. Lista las etapas del pipeline de la organización en orden de visualización.

​
Request

curl https://panel.flowestate.app/api/v1/pipeline/stages \
  -H "Authorization: Bearer fe_k_tu_key_aqui"

​
Response 200

{
  "data": [
    {
      "id": "stage_...",
      "name": "Nuevo",
      "color": "#0ea5e9",
      "order": 0,
      "stageKind": "open",
      "systemKey": "new",
      "createdAt": "2025-10-01T12:00:00.000Z",
      "updatedAt": "2026-01-15T18:00:00.000Z"
    },
    {
      "id": "stage_...",
      "name": "Contactado",
      "color": "#a855f7",
      "order": 1,
      "stageKind": "open",
      "systemKey": "contacted",
      "createdAt": "2025-10-01T12:00:00.000Z",
      "updatedAt": "2025-10-01T12:00:00.000Z"
    }
  ]
}

​
Campos

CampoDescripción
idUUID. Úsalo en POST /leads y PUT /leads/{id} como el campo stageId.
nameNombre de display en el panel. Puede estar localizado o personalizado por la organización.
colorColor hex usado por el tablero del panel.
orderOrden de visualización. Números más bajos van primero.
stageKindBucket del ciclo de vida: open, won, lost.
systemKeyClave opcional que matchea con una de las etapas del sistema (new, contacted, etc.). Puede ser null para etapas totalmente personalizadas.
Usa systemKey si necesitas detectar la etapa canónica. Usa id cuando necesites enrutar un lead a una columna específica.