---
title: "Deletes all contacts from a given list."
method: POST
path: "/v2/address-books/{addressBookId}/contacts/delete-all"
tags: ["ApiContact"]
---

# Deletes all contacts from a given list.

`POST /v2/address-books/{addressBookId}/contacts/delete-all`

## Request

- Base URL: `https://api.dotdigital.com`
- URL: `https://api.dotdigital.com/v2/address-books/{addressBookId}/contacts/delete-all`
- Auth: none declared
- TypeScript: <https://skmtc.dev/dotdigital/apis/apiconnector-com/docs/v2/address-books/:addressBookId/contacts/delete-all/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `addressBookId` integer, required

## Response `202`

- ApiBulkContactDeletion
  - `id` string, guid
  - `status` 'Started' | 'Completed' | 'Failed' | 'NotAvailableInThisVersion'

---

[API](https://skmtc.dev/dotdigital/apis/apiconnector-com.md) - [All operations](https://skmtc.dev/dotdigital/apis/apiconnector-com/llms.txt) - [OpenAPI document](https://skmtc.dev/dotdigital/apis/apiconnector-com/revisions/391b93e8d24a?raw)