---
title: "Delete Contacts"
method: POST
path: "/v1/contact/bulk_delete"
tags: ["contact"]
---

# Delete Contacts

`POST /v1/contact/bulk_delete`

## Request

- Base URL: `https://api.linktodm.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.linktodm.com/v1/contact/bulk_delete`
- Auth: HTTP bearer

Permanently delete contacts (ticked, or all the query selects) and
everything stored against them.

## Request body

- ContactsDeletePayload
  - `contact_ids` integer[], nullable
  - `query` ContactQuerySchema
    - `instagram_user_id` string, nullable
    - `channel_id` string, nullable
    - `has_email` boolean, nullable
    - `has_phone` boolean, nullable
    - `tag_names` string[], nullable
    - `contact_ids` integer[], nullable
    - `tags_match` 'any' | 'all'
    - `clicked_link` boolean, nullable
    - `field_filters` ContactFieldFilter[], nullable
      - `slug` string, required
      - `operator` 'any_of' | 'none_of' | 'is_set' | 'not_set'
      - `values` string[]
    - `came_from` string[], nullable
    - `location_filters` ContactLocationFilter[], nullable
      - `dimension` 'country' | 'city' | 'postal_code', required
      - `operator` 'any_of' | 'none_of'
      - `values` string[]
    - `interacted_after` string, date-time, nullable
    - `interacted_before` string, date-time, nullable
    - `search` string, nullable
    - `page` integer
    - `limit` integer
    - `automation_id` integer, nullable
    - `flow_automation_id` integer, nullable
    - `record_id` string, nullable
    - `new_this_week` boolean, nullable
    - `created_after` string, date-time, nullable
    - `created_before` string, date-time, nullable
    - `order_by` string, nullable

## Response `200`

Successful Response

- ContactsDeleteResponse
  - `deleted` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/linktodm/apis/salesmorph.md) - [All operations](https://skmtc.dev/linktodm/apis/salesmorph/llms.txt) - [OpenAPI document](https://skmtc.dev/linktodm/apis/salesmorph/revisions/4af0ad5dbe92?raw)