Skip to main content
POST
Critical for inbox management - get all unread replies in one view. Essential for ensuring timely responses to leads and preventing missed opportunities.

Overview

Retrieves all unread replies from leads across all campaigns. This endpoint is essential for maintaining inbox zero and ensuring no lead response goes unnoticed. Key Features:
  • Unified view of all unread responses
  • Same comprehensive filtering as other inbox endpoints
  • Real-time unread count tracking
  • Optional full message history
  • Priority handling for urgent responses
Common Use Cases:
  • Daily inbox review: Start your day with unread replies
  • Team notifications: Alert team members of unread messages
  • SLA monitoring: Track response times on unread messages
  • Priority routing: Identify high-value unread leads
  • Dashboard metrics: Display unread count badges

Query Parameters

string
required
Your SmartLead API key
boolean
default:"false"
Include full email thread history
  • false: Only latest message (recommended for list views)
  • true: Complete conversation thread (use for detail views)

Request Body

number
default:"0"
Number of records to skip for pagination. Must be non-negative.
number
default:"20"
Number of records to return per page. Must be between 1 and 20.
object
Advanced filtering options to segment unread replies
string
default:"REPLY_TIME_DESC"
Sort order for results
  • REPLY_TIME_DESC: Most recent replies first (default, recommended)
  • SENT_TIME_DESC: Most recently sent emails first

Response Codes

Success
Request successful - unread replies retrieved
Unauthorized
Invalid or missing API key
Validation Error
Request validation failed. Common issues:
  • limit > 20
  • More than 5 campaign IDs
  • More than 10 items in other array filters
  • Invalid date format
Internal Server Error
Server error occurred

Common Workflows

Morning Inbox Zero Routine

Real-time Unread Counter

Unread SLA Monitor

Priority Triage System

Batch Mark as Read

Filtering Best Practices

1. Prioritize by Time

2. Combine Category Filters

3. Team-specific Views

4. Campaign-specific Monitoring

Performance Tips

  1. Disable message history for counts: 10x faster
  2. Use limit=1 for counters: Minimal data transfer
  3. Filter by campaign: Reduces query scope
  4. Cache unread count: Update every 5-10 minutes
  5. Paginate large results: Limit=20 is optimal

Real-time Monitoring

Integration Examples

Slack Notifications

Dashboard Widget