Master Inbox
Get Unread Replies
Retrieve all unread replies from leads to ensure no important responses are missed
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
- 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
Your SmartLead API key
Include full email thread history
false: Only latest message (recommended for list views)true: Complete conversation thread (use for detail views)
Request Body
Number of records to skip for pagination. Must be non-negative.
Number of records to return per page. Must be between 1 and 20.
Advanced filtering options to segment unread replies
Sort order for results
REPLY_TIME_DESC: Most recent replies first (default, recommended)SENT_TIME_DESC: Most recently sent emails first
Response Codes
Request successful - unread replies retrieved
Invalid or missing API key
Request validation failed. Common issues:
limit> 20- More than 5 campaign IDs
- More than 10 items in other array filters
- Invalid date format
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
- Disable message history for counts: 10x faster
- Use limit=1 for counters: Minimal data transfer
- Filter by campaign: Reduces query scope
- Cache unread count: Update every 5-10 minutes
- Paginate large results: Limit=20 is optimal
Real-time Monitoring
Integration Examples
Slack Notifications
Dashboard Widget
Related Endpoints
- Get Inbox Messages - All replies (read + unread)
- Mark Read Status - Mark as read/unread
- Get Important - Flagged messages
- Get Assigned to Me - Your assigned replies
- Update Category - Categorize leads
- Reply to Message - Send reply
