---
title: "Deletes the contact with the specified phone number."
method: DELETE
path: "/dashboards/{dashboard_id}/contacts/{phone_number}"
tags: ["Contacts"]
---

# Deletes the contact with the specified phone number.

`DELETE /dashboards/{dashboard_id}/contacts/{phone_number}`

If a contact does not exist with this phone number in this dashboard, no content will be returned. If a contact does exist, but has no message history, no content will be returned, and a successful status code will indicate it was deleted. If a contact has any message history, it cannot be deleted, then a Bad Request error will be returned.

## Path parameters

- `dashboard_id` integer, required
- `phone_number` string, required

## Response `200`

The contact was deleted.

## Other responses

- `400` — Thrown if the dashboard id or phone number is invalid, or if the contact exists, but has a message history.
- `401` — Unauthorized. Sent if the API key is omitted or invalid.
- `404` — Thrown if no contact with the specified phone number exists in the dashboard.

---

[API](https://skmtc.net/textrequest/apis/text-request-api-v3.md) · [All operations](https://skmtc.net/textrequest/apis/text-request-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/textrequest/text-request-api-v3/revisions/e4e42efcd650/schema)