DELETE
/
api
/
v2
/
domains
/
{id}
import { InboundEmailClient } from '@inboundemail/sdk'

const inbound = new InboundEmailClient('YOUR_API_KEY')

const { data, error } = await inbound.domain.delete('dom_abc123')

if (error) {
  console.error('Error deleting domain:', error)
} else {
  console.log('Domain deleted:', data.message)
  console.log('Deleted resources:', data.deletedResources)
}

{
  "success": true,
  "message": "Successfully deleted domain example.com and all associated resources",
  "deletedResources": {
    "domain": "example.com",
    "emailAddresses": 5,
    "dnsRecords": 3,
    "blockedEmails": 2,
    "sesIdentity": true,
    "sesReceiptRules": true
  }
}

​
Overview

This endpoint permanently deletes a domain and all associated resources. This includes email addresses, DNS records, blocked emails, AWS SES receipt rules, and the SES identity.
This action is irreversible. All emails and configuration associated with this domain will be permanently deleted.

​
Authentication

​
Authorization
string
required
Bearer token for API authentication. Format: Bearer YOUR_API_KEY

​
Parameters

​
id
string
required
The unique identifier of the domain to delete.

​
Response

​
success
boolean
required
Whether the deletion was successful.
​
message
string
required
Success message describing what was deleted.
​
deletedResources
object
required
Summary of all resources that were deleted.

​
Examples

​
Request

import { InboundEmailClient } from '@inboundemail/sdk'

const inbound = new InboundEmailClient('YOUR_API_KEY')

const { data, error } = await inbound.domain.delete('dom_abc123')

if (error) {
  console.error('Error deleting domain:', error)
} else {
  console.log('Domain deleted:', data.message)
  console.log('Deleted resources:', data.deletedResources)
}

​
Response

{
  "success": true,
  "message": "Successfully deleted domain example.com and all associated resources",
  "deletedResources": {
    "domain": "example.com",
    "emailAddresses": 5,
    "dnsRecords": 3,
    "blockedEmails": 2,
    "sesIdentity": true,
    "sesReceiptRules": true
  }
}

​
Error Responses

{
  "error": "Domain not found"
}

​
Deletion Process

The domain deletion process follows these steps:
1

Validate Domain Ownership

Verify that the domain exists and belongs to the authenticated user.
2

Remove AWS SES Receipt Rules

Delete both catch-all and individual email receipt rules from AWS SES.
This prevents any new emails from being processed for this domain.
3

Delete AWS SES Identity

Remove the domain identity from AWS SES to complete the AWS cleanup.
This step is irreversible and will immediately stop email receiving for the domain.
4

Clean Up Database Records

Delete all associated records in the following order:
  • Blocked emails
  • Email addresses
  • DNS records
  • Domain record
All data is permanently removed from the database.

​
Important Notes

Domain deletion is permanent and cannot be undone. All emails, addresses, and configuration will be lost.
If AWS SES operations fail, the domain will still be deleted from the database. You may need to manually clean up AWS resources if needed.
Before deleting a domain, consider downloading any important emails or exporting configuration if you need to recreate the domain later.

​
What Gets Deleted

When you delete a domain, the following resources are permanently removed:

​
Email Resources

  • All email addresses configured for the domain
  • All received emails stored for the domain
  • All blocked email entries for the domain

​
DNS Configuration

  • All DNS records required for domain verification
  • Verification status and history

​
AWS SES Configuration

  • Domain identity in AWS SES
  • All receipt rules (catch-all and individual email rules)
  • SES verification tokens and status

​
Domain Settings

  • Catch-all configuration
  • Domain verification status
  • Provider detection information
  • All timestamps and metadata

​
After Deletion

After successfully deleting a domain:
  • The domain can be re-added as a new domain (it will go through verification again)
  • AWS SES resources are cleaned up and billing should stop
  • All email receiving for the domain stops immediately
  • DNS records in your DNS provider remain (you may want to remove them manually)
Before deleting a domain, you might want to:
  • Export data: Download emails or configuration
  • Update forwarding: Redirect emails to other domains
  • Check usage: Review email statistics or recent activity

​
Notes

  • Domain deletion affects all users who have access to the domain
  • AWS SES cleanup is attempted but may not always succeed (this doesn’t prevent domain deletion)
  • DNS records in your DNS provider are not automatically removed
  • The domain can be re-added later, but all configuration will need to be set up again
  • Billing for the domain stops immediately after deletion
1.0 - ✅