Skip to main content
GET
/
funnel
/
v1
/
stages
curl -X GET "https://api.whaapy.com/funnel/v1/stages" \
  -H "Authorization: Bearer wha_TU_API_KEY"

{
  "stages": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Lead",
      "position": 0,
      "color": "#6366f1",
      "contact_count": 120,
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-01-28T10:00:00Z"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "name": "Qualified",
      "position": 1,
      "color": "#10b981",
      "contact_count": 45,
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-01-28T10:00:00Z"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "name": "Closed",
      "position": 2,
      "color": "#f59e0b",
      "contact_count": 30,
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-01-28T10:00:00Z"
    }
  ],
  "total": 3
}
Scope requerido: funnels:read
Obtén todas las etapas de tu funnel ordenadas por posición, incluyendo el número de contactos en cada una.
Las etapas siempre se devuelven ordenadas por position (ascendente). El contact_count se calcula dinámicamente.

​
Ejemplos

curl -X GET "https://api.whaapy.com/funnel/v1/stages" \
  -H "Authorization: Bearer wha_TU_API_KEY"

​
Respuesta Exitosa

{
  "stages": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Lead",
      "position": 0,
      "color": "#6366f1",
      "contact_count": 120,
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-01-28T10:00:00Z"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "name": "Qualified",
      "position": 1,
      "color": "#10b981",
      "contact_count": 45,
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-01-28T10:00:00Z"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "name": "Closed",
      "position": 2,
      "color": "#f59e0b",
      "contact_count": 30,
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-01-28T10:00:00Z"
    }
  ],
  "total": 3
}

​
Campos de Respuesta

CampoTipoDescripción
stagesarrayArray de etapas ordenadas por posición
stages[].idstringUUID de la etapa
stages[].namestringNombre de la etapa
stages[].positionnumberPosición en el funnel (0 = primera)
stages[].colorstringColor en formato hex
stages[].contact_countnumberNúmero de contactos en esta etapa
totalnumberTotal de etapas

​
Errores

​
401 Unauthorized

{
  "error": "unauthorized",
  "message": "API key inválida o expirada"
}

​
403 Forbidden

{
  "error": "forbidden",
  "message": "Scope 'funnels:read' requerido"
}

​
Próximos Pasos

Crear Etapa

Agregar nueva etapa al funnel

Mover Contacto

Mover contacto entre etapas

Reordenar

Cambiar orden de etapas

Listar Contactos

Filtrar contactos por etapa