Skip to main content
DELETE
https://api.mailgreet.com
/
api
/
v1
/
external
/
subscribers
/
{subscriberId}
curl -X DELETE "https://api.mailgreet.com/api/v1/external/subscribers/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "message": "Subscriber deleted successfully"
}

​
Overview

Permanently delete a subscriber from your MailGreet account. This action cannot be undone.
This is a destructive action. Once deleted, the subscriber and all associated data (engagement history, custom field values, group memberships) will be permanently removed.

​
Authentication

​
Authorization
string
required
Bearer token. Format: Bearer YOUR_API_KEY

​
Path Parameters

​
subscriberId
string
required
The unique identifier (UUID) of the subscriber to delete.Example: 550e8400-e29b-41d4-a716-446655440000

​
Response

​
success
boolean
Indicates if the subscriber was deleted successfully
​
message
string
Confirmation message
curl -X DELETE "https://api.mailgreet.com/api/v1/external/subscribers/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "message": "Subscriber deleted successfully"
}

​
Best Practices

Consider unsubscribing instead of deleting: If you want to stop sending emails to a subscriber but keep their data for analytics, use the Update Subscriber endpoint to set their status to unsubscribed instead of deleting them.

​
When to Delete vs Unsubscribe

ActionUse Case
DeleteGDPR/data deletion requests, duplicate records, test data cleanup
UnsubscribeUser opts out, temporary pause, compliance requirements