MailerDeleteProfile

DELETE mailer/providerProfile

Soft-deletes a provider profile and takes it out of routing. Email history keeps pointing at it.

The deletion is refused while the profile still has unsent emails: dropping it would leave them with no way out of the queue.

Access Control

Allowed role: admin, within the brand of the caller.

Request

RESTTCPSDK

DELETE request

DELETE https://{broker_domain}/mailer/providerProfile?id=3
Authorization: <JWT_TOKEN>

{
  "command": "MailerDeleteProfile",
  "extID": "1",
  "data": {
    "id": 3
  }
}

const res = await platform.MailerDeleteProfile({
  id: 3
});

Request Data

Field	Type	Required	Description
id	int	Yes	Profile id

Response Data

{
  "id": 3,
  "deleted": true,
  "message": "Profile with ID 3 has been deleted"
}

Errors

Code	Error	Description
404	NOT_FOUND	Profile not found in the brand
409	PROFILE_IN_USE	The profile still has emails in the queue