curl -X DELETE https://api.whaapy.com/funnel/v1/stages/550e8400-e29b-41d4-a716-446655440000 \
-H "Authorization: Bearer wha_TU_API_KEY"
const stageId = '550e8400-e29b-41d4-a716-446655440000';
const response = await fetch(
`https://api.whaapy.com/funnel/v1/stages/${stageId}`,
{
method: 'DELETE',
headers: { 'Authorization': 'Bearer wha_TU_API_KEY' }
}
);
import requests
stage_id = '550e8400-e29b-41d4-a716-446655440000'
response = requests.delete(
f'https://api.whaapy.com/funnel/v1/stages/{stage_id}',
headers={'Authorization': 'Bearer wha_TU_API_KEY'}
)
$stageId = '550e8400-e29b-41d4-a716-446655440000';
$ch = curl_init("https://api.whaapy.com/funnel/v1/stages/{$stageId}");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer wha_TU_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
{
"success": true,
"message": "Etapa eliminada",
"stage_id": "550e8400-e29b-41d4-a716-446655440000"
}
Funnels
Eliminar Etapa
Elimina una etapa del funnel
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"
const stageId = '550e8400-e29b-41d4-a716-446655440000';
const response = await fetch(
`https://api.whaapy.com/funnel/v1/stages/${stageId}`,
{
method: 'DELETE',
headers: { 'Authorization': 'Bearer wha_TU_API_KEY' }
}
);
import requests
stage_id = '550e8400-e29b-41d4-a716-446655440000'
response = requests.delete(
f'https://api.whaapy.com/funnel/v1/stages/{stage_id}',
headers={'Authorization': 'Bearer wha_TU_API_KEY'}
)
$stageId = '550e8400-e29b-41d4-a716-446655440000';
$ch = curl_init("https://api.whaapy.com/funnel/v1/stages/{$stageId}");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer wha_TU_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
{
"success": true,
"message": "Etapa eliminada",
"stage_id": "550e8400-e29b-41d4-a716-446655440000"
}
Scope requerido:
funnels:writeNo 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
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"
const stageId = '550e8400-e29b-41d4-a716-446655440000';
const response = await fetch(
`https://api.whaapy.com/funnel/v1/stages/${stageId}`,
{
method: 'DELETE',
headers: { 'Authorization': 'Bearer wha_TU_API_KEY' }
}
);
import requests
stage_id = '550e8400-e29b-41d4-a716-446655440000'
response = requests.delete(
f'https://api.whaapy.com/funnel/v1/stages/{stage_id}',
headers={'Authorization': 'Bearer wha_TU_API_KEY'}
)
$stageId = '550e8400-e29b-41d4-a716-446655440000';
$ch = curl_init("https://api.whaapy.com/funnel/v1/stages/{$stageId}");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer wha_TU_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
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 webhookfunnel_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
Was this page helpful?