Etapas del pipeline

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.

Generales

Leads

Catálogo

Organización

Automatización

Webhooks

`GET /pipeline/stages`

Request

Response 200

Campos

​GET /pipeline/stages

​Request

​Response 200

​Campos

`GET /pipeline/stages`

Request

Response 200

Campos