Skip to main content
PATCH
/
funnel
/
v1
/
stages
/
{id}
curl -X PATCH https://api.whaapy.com/funnel/v1/stages/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer wha_TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Hot Lead",
    "color": "#ef4444"
  }'
{
  "stage": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Hot Lead",
    "position": 0,
    "color": "#ef4444",
    "contact_count": 120,
    "created_at": "2026-01-01T00:00:00Z",
    "updated_at": "2026-01-28T12:30:00Z"
  }
}
Scope requerido: funnels:write
Modifica las propiedades de una etapa existente. Solo envía los campos que quieres modificar.

Path Parameters

id
string
required
UUID de la etapa a actualizar

Body Parameters

name
string
Nuevo nombre (1-100 caracteres)
color
string
Nuevo color en formato hex
Envía solo los campos que quieres modificar.

Ejemplos

curl -X PATCH https://api.whaapy.com/funnel/v1/stages/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer wha_TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Hot Lead",
    "color": "#ef4444"
  }'

Respuesta Exitosa

{
  "stage": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Hot Lead",
    "position": 0,
    "color": "#ef4444",
    "contact_count": 120,
    "created_at": "2026-01-01T00:00:00Z",
    "updated_at": "2026-01-28T12:30:00Z"
  }
}

Errores

400 Bad Request

{
  "error": "validation_error",
  "message": "Datos inválidos",
  "details": {
    "color": ["Color inválido. Usar formato hex: #RRGGBB"]
  }
}

404 Not Found

{
  "error": "not_found",
  "message": "Etapa no encontrada"
}

Webhooks

Cuando actualizas una etapa, se dispara el webhook funnel_stage.updated:
{
  "event": "funnel_stage.updated",
  "data": {
    "stage_id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Hot Lead",
    "color": "#ef4444",
    "updated_at": "2026-01-28T12:30:00Z"
  }
}

Próximos Pasos