> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velafi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Eliminar un webhook

> Elimina de forma permanente un endpoint de webhook registrado mediante su webhookId. VelaFi deja de entregar de inmediato todos los eventos a la URL de callback.

Usa este endpoint para eliminar de forma permanente un endpoint de webhook. Una vez eliminado, VelaFi deja de enviar de inmediato notificaciones de eventos a la URL asociada. Los webhooks eliminados aparecen en [Listar webhooks](https://docs.velafi.com/es/api-reference/webhooks/get-webhook-endpoints.md) con `status: 30`, pero no se pueden restaurar; crea un webhook nuevo si necesitas volver a registrar la misma URL o el mismo tipo de evento.

> [!NOTE]
>
> Todas las solicitudes deben incluir el encabezado `X-BH-TOKEN` con un token obtenido de `GET /v2/token/generate` (consulta [Autenticación](https://docs.velafi.com/es/api-reference/authentication.md)). La eliminación es irreversible.

## Endpoint

`DELETE https://api.velafi.com/v2/webhook/{webhookId}`

## Parámetro de ruta

**webhookId** `string` *required*

ID único del webhook que se eliminará. Lo obtienes de la respuesta de [Listar webhooks](https://docs.velafi.com/es/api-reference/webhooks/get-webhook-endpoints.md).

## Campos de la respuesta

**code** `number`

Código de respuesta de tipo HTTP. `200` indica éxito.

**msg** `string`

Mensaje de estado legible, por ejemplo `SUCCESS`.

**data** `boolean`

`true` si el webhook se eliminó.

## Ejemplo

```bash cURL theme={null}
curl -X DELETE https://api.velafi.com/v2/webhook/ebab8a9663704e7cbbebe672c7c67912 \
  -H "X-BH-TOKEN: YOUR_TOKEN"
```

```json Respuesta theme={null}
{
  "code": 200,
  "msg": "SUCCESS",
  "data": true
}
```

> [!WARNING]
>
> La eliminación es permanente y no se puede deshacer. Los eventos que ocurren mientras no existe un webhook activo para el tipo de evento no se ponen en cola. Los eventos que ya están en cola no se cancelan: si creas un webhook nuevo para el mismo tipo de evento en un plazo aproximado de 15 días, se entregan a la URL del webhook nuevo con el `webhookId` del webhook eliminado. Crea un webhook nuevo de inmediato si necesitas que la entrega continúe.


## Related topics

- [Eliminar un beneficiario](https://docs.velafi.com/es/api-reference/beneficiary/delete-beneficiary.md)
- [Actualizar un webhook](https://docs.velafi.com/es/api-reference/webhooks/update-a-webhook.md)
- [Crear un webhook](https://docs.velafi.com/es/api-reference/webhooks/create-webhook-endpoints.md)
- [Eliminar una dirección de la lista blanca](https://docs.velafi.com/es/api-reference/crypto-wallet/delete-whitelist-address.md)
- [Evento de retiro cripto](https://docs.velafi.com/es/api-reference/webhooks/crypto-withdraw-message-push.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.