Skip to navigation
API ReferenceTags

Delete a tag permanently

Deletes a tag permanently. Deleting a tag removes the tag from any messages that have been sent, and also deletes the tag’s stats. There is no way to undo this operation, so use it carefully.

Request

This endpoint expects an object.
keystringRequired
A valid Mandrill API key
tagstringRequired
An existing tag name

Response

Success
tagstring
The name of the tag that was deleted
sentinteger
Total number of emails sent with this tag before deletion
hard_bouncesinteger
Total number of hard bounces for emails with this tag before deletion
soft_bouncesinteger
Total number of soft bounces for emails with this tag before deletion
rejectsinteger
Total number of rejected emails with this tag before deletion
complaintsinteger
Total number of spam complaints for emails with this tag before deletion
unsubsinteger
Total number of unsubscribe requests for emails with this tag before deletion
opensinteger
Total number of times emails with this tag were opened before deletion
clicksinteger
Total number of tracked URLs clicked in emails with this tag before deletion
unique_opensinteger
Total number of unique opens for emails with this tag before deletion
unique_clicksinteger
Total number of unique clicks for emails with this tag before deletion
reputationinteger0-100
Final reputation score of the tag before deletion

Errors

400
Bad Request Error
401
Unauthorized Error
500
Internal Server Error