Master Inbox
Get Inbox Replies
Retrieve all lead replies across all campaigns in your unified inbox
POST
Your central hub for all lead responses across campaigns. Essential for managing conversations, tracking engagement, and ensuring no reply goes unnoticed.
Overview
Retrieves all replies from leads across all campaigns in your unified inbox. This is the primary endpoint for managing all incoming responses from your outreach efforts. Key Features:- Unified view of all replies across campaigns
- Optional full message history retrieval
- Comprehensive filtering by campaign, account, team, tags, clients
- Lead category filtering
- Date range and engagement status filtering
- Flexible sorting options
- Response management: Central inbox for all campaign replies
- Team collaboration: Filter by assigned team members
- Performance tracking: Monitor reply rates and patterns
- Lead qualification: Filter by category and engagement
- Client reporting: Segment replies by client
- Follow-up workflows: Identify leads needing attention
Query Parameters
Your SmartLead API key
Include full email thread history.
true: Returns complete conversation thread (slower, more data)false: Returns only latest message (faster, recommended for list views)
false for list views, true only when viewing individual conversations.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
Sort order for results
REPLY_TIME_DESC: Most recent replies first (default)SENT_TIME_DESC: Most recently sent emails first
Response Codes
Request successful - inbox replies retrieved
Invalid or missing API key
Request validation failed. Common issues:
limit> 20- More than 5 campaign IDs
- More than 20 email account IDs
- More than 10 items in other array filters
- Invalid date format
Server error occurred
Common Workflows
Daily Inbox Check
Priority Lead Follow-up
Team Workload Distribution
Campaign Performance Monitor
Message History vs List View
When to Use fetch_message_history=false (Recommended)
- ✅ List views: Displaying inbox overview
- ✅ Counting replies: Just need totals
- ✅ Quick filtering: Finding specific leads
- ✅ Dashboard displays: Overview metrics
- ✅ Mobile apps: Faster loading
- ✅ Pagination: Browsing multiple pages
When to Use fetch_message_history=true
- ✅ Conversation view: Displaying full thread
- ✅ Reply context: Need full conversation history
- ✅ AI analysis: Processing full threads
- ✅ Detailed reporting: Complete interaction data
- ✅ CRM sync: Syncing full conversation history
Filtering Best Practices
1. Use Appropriate Array Limits
2. Combine Category Filters
3. Smart Date Ranges
4. Progressive Filtering
Performance Optimization
- Disable message history for lists: 10x faster
- Use pagination properly: Limit=20 is optimal
- Filter by campaign/account: Reduces query scope
- Cache frequently accessed data: Store client-side
- Batch similar requests: Group by filter criteria
- Use appropriate sort orders: Match your use case
Error Handling
Related Endpoints
- Get Sent Emails - All sent emails
- Get Unread Replies - Only unread replies
- Get Assigned to Me - My assigned replies
- Get Important - Flagged replies
- Mark Read - Update read status
- Update Category - Categorize leads
- Reply to Message - Send reply
