---
title: "Remove contacts from a list"
method: DELETE
path: "/contact-lists/{id}/contacts"
tags: ["ContactLists"]
---

# Remove contacts from a list

`DELETE /contact-lists/{id}/contacts`

## Request

- Base URL: `https://api.supersendtx.com`
- URL: `https://api.supersendtx.com/contact-lists/{id}/contacts`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Query parameters

- `contact_ids` string

## Request body

- ContactListMembershipRequest
  - `contact_ids` string[]
  - `emails` string[]

## Response `200`

Membership updated

- RemoveContactListMembersResponse
  - `removed` integer, required
  - `contact_count` integer, required: Size of the list after the change
  - `not_found` string[], required

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key
- `404`: Contact list not found

---

[API](https://skmtc.dev/ranla/apis/supersend-tx-api.md) · [All operations](https://skmtc.dev/ranla/apis/supersend-tx-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ranla/apis/supersend-tx-api/revisions/e3e782652f50?raw)