---
title: "Delete a sender profile"
method: DELETE
path: "/v3/sender-profiles/{id}"
tags: ["Sender Profiles"]
---

# Delete a sender profile

`DELETE /v3/sender-profiles/{id}`

## Request

- Base URL: `https://api.sent.dm`
- URL: `https://api.sent.dm/v3/sender-profiles/{id}`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Deletes one of your sender profiles and returns `204`.

The delete is **soft**: the profile stops being usable and stops appearing in reads, and its message history is kept, because deleting a profile must not delete the record of what it sent.

## What it releases

Anything the profile still held goes with it. A **phone number** returns to our inventory and can be given to whoever asks next — it does not stay reserved for you, and getting the same number back afterwards is not something we can promise. A **WhatsApp account of its own** is deregistered from Meta. Its routing rules stop being used, so nothing sends through the profile after this call.

A profile that only inherits from its organization holds nothing of its own and releases nothing.

## When it is refused

A number the profile holds that your **WhatsApp Business Account still carries** refuses the delete with a `409 CONFLICT_012`, and nothing is deleted: it would return to our shared inventory while Meta still routes WhatsApp to it, and the next customer given it could not register it at all. Only you can take it off the account — deregister **and** delete it in WhatsApp Manager, then try again. A `409 CONFLICT_013` means we could not read the account, so we cannot tell either way.

## Path parameters

- `id` string, uuid, required

## Response `204`

Deleted, and anything it held released

## Other responses

- `401`: Unauthorized
- `403`: The profile or your organization is suspended (`ACCOUNT_SUSPENDED`)
- `404`: No such profile under your organization
- `409`: Refused, nothing deleted: a number the profile holds is still on your WhatsApp Business Account, or that account could not be read
- `500`: Server Error

## Changes

- **2026-10-28** `41acb2ceb84d`: 1 info
  - added the media type `application/json` for the response with the status `403`
- **2026-10-20** `3eaea6f4015a`: 1 info
  - added the non-success response with the status `409`
- **2026-10-16** `6c829543a93e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sentdm/apis/sent-dm-api-v3/changes/v3/sender-profiles/:id/delete.md)

---

[API](https://skmtc.dev/sentdm/apis/sent-dm-api-v3.md) - [All operations](https://skmtc.dev/sentdm/apis/sent-dm-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/sentdm/apis/sent-dm-api-v3/revisions/bdcca958cac7?raw)