Skip to main content
DELETE

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

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