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
| Campo | Descripción |
|---|
id | UUID. Úsalo en POST /leads y PUT /leads/{id} como el campo stageId. |
name | Nombre de display en el panel. Puede estar localizado o personalizado por la organización. |
color | Color hex usado por el tablero del panel. |
order | Orden de visualización. Números más bajos van primero. |
stageKind | Bucket del ciclo de vida: open, won, lost. |
systemKey | Clave 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.
