Skip to main content

Data Deletion

Posta provides endpoints for GDPR-compliant data deletion.

Delete Contact Data​

Remove all data associated with a specific email address, or all contacts:

POST /api/v1/users/me/gdpr/delete-contacts

Delete a Specific Contact​

{
  "email": "user@example.com"
}

Delete All Contacts​

{
  "email": null
}

Response:

{
  "success": true,
  "data": {
    "deleted_count": 1
  }
}

This removes the contact from:

  • The contacts list
  • All contact lists
  • The suppression list

Delete Email Logs​

Remove email logs older than a specified number of days:

POST /api/v1/users/me/gdpr/delete-email-logs

Delete Logs Older Than 30 Days​

{
  "older_than_days": 30
}

Delete All Email Logs​

{
  "older_than_days": 0
}

Response:

{
  "success": true,
  "data": {
    "deleted_count": 1500
  }
}

Automatic Retention​

Administrators can configure automatic data retention via Platform Settings:

  • email_retention_days — Auto-delete email logs after N days
  • webhook_retention_days — Auto-delete webhook delivery history after N days
  • audit_log_retention_days — Auto-delete audit log entries after N days

The retention cleanup job runs daily at 2:00 AM.