Skip to main content
POST
/
api
/
v1
/
master-inbox
/
reminders
curl -X POST "https://server.smartlead.ai/api/v1/master-inbox/reminders?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sortBy": "REMINDER_TIME_ASC", "limit": 20}'

{
  "messages": [{
    "campaign_lead_map_id": "2433664091",
    "lead": {"email": "john@company.com"},
    "reminder_time": "2025-01-20T14:00:00Z",
    "reminder_message": "Follow up on pricing question",
    "is_overdue": false
  }],
  "total_count": 1
}
Track all emails with reminders set. Essential for follow-up management and ensuring timely responses to important leads.

​
Overview

Retrieves emails with active reminders. Unique sorting by reminder time (ascending/descending) helps prioritize upcoming vs overdue reminders. Reminder Sorting (Unique to this endpoint):
  • REMINDER_TIME_DESC: Most recent/future reminders first
  • REMINDER_TIME_ASC: Earliest/overdue reminders first (recommended for daily review)

​
Query Parameters

​
api_key
string
required
Your SmartLead API key
Note: This endpoint does NOT support fetch_message_history parameter (unlike other inbox endpoints)

​
Request Body

​
offset
number
default:"0"
Pagination offset
​
limit
number
default:"20"
Records per page (1-20)
​
filters
object
Filter object with the following optional fields: search (string), campaignId (number or array, max 5), emailAccountId (number or array, max 10), emailStatus (string or array — valid values: Opened, Clicked, Replied, Unsubscribed, Bounced, Accepted, Not Replied), leadCategories (object with categoryIdsIn, categoryIdsNotIn, unassigned, isAssigned), campaignTeamMemberId (number or array, max 10), campaignTagId (number or array, max 10), campaignClientId (number or array, max 10), replyTimeBetween (array of 2 date strings).
​
sortBy
string
Unique Sort Options:
  • REMINDER_TIME_ASC: Earliest reminders first (overdue → upcoming)
  • REMINDER_TIME_DESC: Latest reminders first (upcoming → overdue)
curl -X POST "https://server.smartlead.ai/api/v1/master-inbox/reminders?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sortBy": "REMINDER_TIME_ASC", "limit": 20}'

​
Response Example

{
  "messages": [{
    "campaign_lead_map_id": "2433664091",
    "lead": {"email": "john@company.com"},
    "reminder_time": "2025-01-20T14:00:00Z",
    "reminder_message": "Follow up on pricing question",
    "is_overdue": false
  }],
  "total_count": 1
}