Sender Profiles

Delete a sender profile

Changed on

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.

delete/v3/sender-profiles/{id}

Request

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

Path parameters

idstring uuid required

Identifier of the profile.

Response

Deleted, and anything it held released

Changes