Skip to main content
DELETE
/
funnel
/
v1
/
stages
/
{id}
curl -X DELETE https://api.whaapy.com/funnel/v1/stages/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer wha_TU_API_KEY"

{
  "success": true,
  "message": "Etapa eliminada",
  "stage_id": "550e8400-e29b-41d4-a716-446655440000"
}
Scope requerido: funnels:write
Elimina una etapa del funnel. Solo es posible si no hay contactos en esa etapa.
No puedes eliminar una etapa que tenga contactos. Primero debes mover los contactos a otra etapa usando POST /funnel/v1/contacts/:id/move o la API de operaciones masivas.

​
Path Parameters

​
id
string
required
UUID de la etapa a eliminar

​
Ejemplos

curl -X DELETE https://api.whaapy.com/funnel/v1/stages/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer wha_TU_API_KEY"

​
Respuesta Exitosa

{
  "success": true,
  "message": "Etapa eliminada",
  "stage_id": "550e8400-e29b-41d4-a716-446655440000"
}

​
Errores

​
Etapa no encontrada

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

​
Etapa tiene contactos

{
  "error": "has_contacts",
  "message": "No se puede eliminar la etapa porque tiene 45 contacto(s). Mueve los contactos primero.",
  "contact_count": 45
}
Para mover contactos masivamente antes de eliminar, usa:
POST /contacts/v1/bulk
{
  "operation": "set_funnel_stage",
  "contact_ids": ["uuid-1", "uuid-2", ...],
  "funnel_stage_id": "otra-etapa-uuid"
}

​
Webhooks

Cuando eliminas una etapa, se dispara el webhook funnel_stage.deleted: 
{
  "event": "funnel_stage.deleted",
  "data": {
    "stage_id": "550e8400-e29b-41d4-a716-446655440000",
    "deleted_at": "2026-01-28T12:00:00Z"
  }
}

​
Próximos Pasos

Listar Etapas

Ver etapas restantes

Crear Etapa

Agregar nueva etapa