---
title: "Unsubscribe a contact from a list"
method: DELETE
path: "/v2/contacts"
tags: ["contacts-v2"]
---

# Unsubscribe a contact from a list

`DELETE /v2/contacts`

## Request

- Base URL: `https://api.tracklysms.com/api`
- URL: `https://api.tracklysms.com/api/v2/contacts`
- Auth: API key in header `X-Api-Key`

Sets ListContact.active to False with unsub_reason='api'.

## Request body

- UnsubscribeRequest
  - `list_number` string, required: Sending list phone number in E.164 format
  - `phone_number` string, required: Contact phone number in E.164 format

## Response `200`

Contact unsubscribed

- UnsubscribeResponse
  - `success` boolean: Operation success
  - `unsubscribed` boolean: Whether contact was found and unsubscribed

## Other responses

- `400`: Validation error
- `401`: Authentication error

---

[API](https://skmtc.dev/tracklysms/apis/trackly-sms-api.md) · [All operations](https://skmtc.dev/tracklysms/apis/trackly-sms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tracklysms/apis/trackly-sms-api/revisions/ac1ad22cb2a9?raw)