Lumail.ioLumail.io
DocsBlogChangelog

Getting Started

  • Introduction
  • Tutorials
  • API Reference
  • Integrations
  • Features
  • Workflows

Tutorials

  • Create an API Token
  • Build a V0 Capture Page
  • Dynamic Promo Codes with Webhooks

API Reference

  • API Tokens
  • Rate Limits
  • POSTSend Transactional Email
  • POSTEmail Verification API
  • POSTCreate Subscriber
  • GETGet Subscriber
  • PATCHUpdate Subscriber
  • DELETEDelete Subscriber
  • POSTAdd Tags to Subscriber
  • DELETERemove Tags from Subscriber
  • POSTTrack Event
  • GETGet Subscriber Events
  • GETGet All Tags
  • POSTCreate a Tag
  • Send Email in HTML
  • Send Email in Markdown
  • Send Email in Tiptap

Integrations

  • ClickFunnels Integration
  • SystemIO Integration

Features

  • Variables
  • Subscriber Events
  • Revenue Tracking
  • Email Deliverability Score
  • Email Engagement Score
  • Content Deliverability Checker

Workflows

  • Wait Step
  • Email Step
  • Action Step
  • Webhook Step

domains

  • Email Domains
  • Web Domains

Delete Subscriber

Remove a subscriber from your Lumail account

https://lumail.io/api/v1/subscribers/{subscriber}

Permanently removes a subscriber and all associated data from your account. This operation cannot be undone.

Response

  • Success (200 OK) - Returns a success message.
  • Error (404 Not Found) - Returned if the subscriber does not exist.

Response Fields

FieldTypeDescription
successbooleanIndicates if the operation was successful
messagestringA message confirming the subscriber was deleted

Request Schema

No request body is required for this endpoint. Identify the subscriber to delete by providing either their unique ID or email address in the URL path.

Usage Example

Use this API endpoint when you need to:

  • Remove subscribers who have requested deletion of their data
  • Clean up your subscriber list by removing invalid or inactive accounts
  • Comply with privacy regulations like GDPR by allowing complete data removal
  • Process unsubscribe requests that require full data deletion
  • Remove test or duplicate subscriber accounts

This action removes the subscriber and all associated data, including:

  • Tags assigned to the subscriber
  • Custom field values
  • Event history
  • Timeline data
Update SubscriberAdd Tags to Subscriber

Method

DELETE

Endpoint

/api/v1/subscribers/{subscriber}

Request Examples

# Delete by ID
curl -X DELETE https://lumail.io/api/v1/subscribers/sub_TTYPR5tWDh \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

# Or delete by email
curl -X DELETE https://lumail.io/api/v1/subscribers/subscriber@example.com \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

Response Examples

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

On This Page

ResponseResponse FieldsRequest SchemaUsage Example

Lumail.io

Create and send e-mail without paying thousands of dollars

Product

BlogDocumentationChangelogDashboard

Company

AboutAccount

Legal

TermsPrivacy

8 The Green STE B, Dover Delaware 19901, United States

© 2025 Codelynx, LLC. All rights reserved.

Sign in