---
title: "Deletar múltiplos contatos"
method: DELETE
path: "/v2/contacts"
tags: ["conversas-v2-contacts"]
---

# Deletar múltiplos contatos

`DELETE /v2/contacts`

ℹ️ API disponível apenas para o plano Advanced.

Deletar múltiplos contatos usando filtros.
É **obrigatório** enviar um de: `tag_name`, `integration` ou `$all`.
O cliente pode excluir por etiqueta pelo nome (`tag_name`).

⚠️ As exclusões realizadas neste recurso são irreversíveis e definitivas.

## Request body

- union
  - object
    - `tag_name` string, required — Nome da etiqueta a qual os contatos estão associados.
  - object
    - `integration` string, required — Nome da integração a qual os contatos estão ligados.
  - object
    - `$all` boolean, required — Sinaliza a exclusão de TODOS os contatos da empresa.

## Response `200`

Contatos excluídos com sucesso

- object
  - `contacts_count` integer, required — Número de contatos excluídos.

## Other responses

- `400` — Bad request
- `401` — Access Token missing or invalid
- `403` — Not authorized to access such resource
- `404` — Resource not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/rdstation/apis/webhook-service.md) · [All operations](https://skmtc.net/rdstation/apis/webhook-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rdstation/webhook-service/revisions/3867c21388e8/schema)