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

# Eliminar Contacto

> Elimina un contacto (soft delete)

Elimina un contacto de tu base de datos. Esta operación es un **soft delete**: el contacto se marca como eliminado pero no se borra físicamente.

<Warning>
  **Comportamiento de soft delete:**

  * El contacto no aparecerá en listados ni búsquedas
  * Las conversaciones históricas se mantienen
  * Si el contacto vuelve a escribir por WhatsApp, se restaurará automáticamente
</Warning>

***

## Path Parameters

<ParamField path="id" type="string" required>
  UUID del contacto a eliminar
</ParamField>

***

## Ejemplos

<RequestExample>
  ```bash cURL theme={null}
  curl -X DELETE https://api.whaapy.com/contacts/v1/550e8400-e29b-41d4-a716-446655440000 \
    -H "Authorization: Bearer wha_TU_API_KEY"
  ```

  ```javascript Node.js theme={null}
  const contactId = '550e8400-e29b-41d4-a716-446655440000';
  const response = await fetch(
    `https://api.whaapy.com/contacts/v1/${contactId}`,
    {
      method: 'DELETE',
      headers: { 'Authorization': 'Bearer wha_TU_API_KEY' }
    }
  );
  const data = await response.json();
  console.log(data.success); // true
  ```

  ```python Python theme={null}
  import requests

  contact_id = '550e8400-e29b-41d4-a716-446655440000'
  response = requests.delete(
      f'https://api.whaapy.com/contacts/v1/{contact_id}',
      headers={'Authorization': 'Bearer wha_TU_API_KEY'}
  )
  print(response.json())
  ```

  ```php PHP theme={null}
  $contactId = '550e8400-e29b-41d4-a716-446655440000';
  $ch = curl_init("https://api.whaapy.com/contacts/v1/{$contactId}");
  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);
  echo $response;
  ```
</RequestExample>

***

## Respuesta Exitosa

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "success": true,
    "message": "Contacto eliminado",
    "contact_id": "550e8400-e29b-41d4-a716-446655440000"
  }
  ```
</ResponseExample>

***

## Errores

<ResponseExample>
  ```json 404 Not Found theme={null}
  {
    "error": "not_found",
    "message": "Contacto no encontrado"
  }
  ```
</ResponseExample>

<ResponseExample>
  ```json 400 Bad Request theme={null}
  {
    "error": "validation_error",
    "message": "ID de contacto inválido"
  }
  ```
</ResponseExample>

***

## Webhooks

Cuando eliminas un contacto, se dispara el webhook `contact.deleted`:

```json theme={null}
{
  "event": "contact.deleted",
  "data": {
    "contact_id": "550e8400-e29b-41d4-a716-446655440000",
    "phone_number": "+5215512345678",
    "deleted_at": "2026-01-28T12:00:00Z"
  }
}
```

***

## Restauración Automática

<Info>
  Si un contacto eliminado vuelve a enviar un mensaje por WhatsApp, Whaapy lo restaura automáticamente con todos sus datos anteriores.
</Info>

Esto asegura que:

* No pierdas contexto de clientes que vuelven
* El historial de conversaciones se mantiene intacto
* Los tags y campos personalizados se preservan

***

## Eliminación Masiva

Para eliminar múltiples contactos a la vez, usa la [API de operaciones masivas](/api-reference/contacts/bulk):

```json theme={null}
{
  "operation": "delete",
  "contact_ids": [
    "uuid-1",
    "uuid-2",
    "uuid-3"
  ]
}
```

***

## Próximos Pasos

<CardGroup cols={2}>
  <Card title="Operaciones Masivas" icon="layer-group" href="/api-reference/contacts/bulk">
    Eliminar múltiples contactos
  </Card>

  <Card title="Listar Contactos" icon="list" href="/api-reference/contacts/list">
    Ver contactos activos
  </Card>

  <Card title="Crear Contacto" icon="user-plus" href="/api-reference/contacts/create">
    Agregar nuevo contacto
  </Card>

  <Card title="Webhooks" icon="webhook" href="/api-reference/webhooks/events">
    Ver eventos disponibles
  </Card>
</CardGroup>