---
title: "Delete Contact Lists"
method: POST
path: "/activities/list_delete"
tags: ["Bulk Activities"]
---

# Delete Contact Lists

`POST /activities/list_delete`

Use this endpoint to delete up to 100 contact lists in an account.

## Request body

- ListIdList100
  - `list_ids` string[], required — The array of contact lists <code>list_id</code> to delete.

## Response `201`

Request successful. Activity queued for processing.

- ActivityDeleteListsResponse
  - `activity_id` string — The system assigned UUID that uniquely identifies an activity.
  - `state` string — The activity processing state.
  - `started_at` string, date-time — Timestamp showing when processing started for the activity, in ISO-8601 format.
  - `completed_at` string, date-time — Timestamp showing when processing completed for the activity, in ISO-8601 format.
  - `created_at` string, date-time — Timestamp showing when the activity was first requested, in ISO-8601 format.
  - `updated_at` string, date-time — Timestamp showing when the activity was last updated, in ISO-8601 format.
  - `percent_done` integer — The processing percent complete for the activity.
  - `activity_errors` string[] — An array of error message strings describing the errors that occurred.
  - `status` object
    - `list_count` integer — The number of lists deleted.
  - `_links` object
    - `self` object — Link to the activity status to use in tracking the request status.
      - `href` string

## Other responses

- `400` — Bad request. Either the JSON was malformed or there was a data validation error.
- `401` — The Access Token used is invalid.
- `403` — Forbidden request. You lack the necessary scopes, you lack the necessary user privileges, or the application is deactivated.
- `429` — Too many requests. You exceeded 1,000 queued activities for this user account.
- `500` — There was a problem with our internal service.
- `503` — Our internal service is temporarily unavailable.

---

[API](https://skmtc.net/cc/apis/appconnect-v3.md) · [All operations](https://skmtc.net/cc/apis/appconnect-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cc/appconnect-v3/revisions/4b4a534c818d/schema)