Skip to main content
POST
/
api
/
v1
/
master-inbox
/
block-domains
curl -X POST "https://server.smartlead.ai/api/v1/master-inbox/block-domains?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domains": ["spam.com", "invalid.com"],
    "source": "manual"
  }'

{
  "success": true,
  "message": "Domains blocked successfully",
  "data": {
    "blocked_domains": ["spam.com", "invalid.com"],
    "source": "manual",
    "blocked_at": "2025-01-20T15:30:00Z"
  }
}
Prevent emails to specific domains. Essential for managing bounces, spam complaints, and invalid domains across all campaigns.

​
Overview

Blocks one or more email domains system-wide to prevent future outreach. Useful for bounce management, spam complaint handling, and maintaining sender reputation. Block Effects:
  • No future emails sent to blocked domains
  • Applies across ALL campaigns
  • Existing leads marked appropriately
  • Can be unblocked later via domain block list management
Common Block Sources:
  • manual: User-initiated block
  • bounce: Auto-block from hard bounces
  • complaint: Spam complaints
  • invalid: Email validation failures

​
Query Parameters

​
api_key
string
required
Your SmartLead API key

​
Request Body

​
domains
array
required
Array of domain strings to block (minimum 1 domain)Examples: ["spam.com", "invalid.com", "bounces.net"]
​
source
string
default:"manual"
Block source for tracking: manual, bounce, complaint, or invalid
curl -X POST "https://server.smartlead.ai/api/v1/master-inbox/block-domains?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domains": ["spam.com", "invalid.com"],
    "source": "manual"
  }'

​
Response Example

{
  "success": true,
  "message": "Domains blocked successfully",
  "data": {
    "blocked_domains": ["spam.com", "invalid.com"],
    "source": "manual",
    "blocked_at": "2025-01-20T15:30:00Z"
  }
}