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}'
import requests
API_KEY = "YOUR_API_KEY"
# Get overdue reminders first
payload = {
"sortBy": "REMINDER_TIME_ASC", # Oldest first
"limit": 20
}
response = requests.post(
"https://server.smartlead.ai/api/v1/master-inbox/reminders",
params={"api_key": API_KEY},
json=payload
)
reminders = response.json()
for msg in reminders.get('messages', []):
print(f"⏰ {msg['lead']['email']} - Reminder: {msg['reminder_time']}")
const API_KEY = 'YOUR_API_KEY';
// Get today's due reminders
const payload = {
sortBy: 'REMINDER_TIME_ASC',
limit: 20
};
const response = await fetch(
`https://server.smartlead.ai/api/v1/master-inbox/reminders?api_key=${API_KEY}`,
{
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(payload)
}
);
const result = await response.json();
console.log(`${result.total_count} reminders`);
{
"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
}
Master Inbox
Get Reminder Emails
Retrieve emails with active reminders sorted by reminder time
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}'
import requests
API_KEY = "YOUR_API_KEY"
# Get overdue reminders first
payload = {
"sortBy": "REMINDER_TIME_ASC", # Oldest first
"limit": 20
}
response = requests.post(
"https://server.smartlead.ai/api/v1/master-inbox/reminders",
params={"api_key": API_KEY},
json=payload
)
reminders = response.json()
for msg in reminders.get('messages', []):
print(f"⏰ {msg['lead']['email']} - Reminder: {msg['reminder_time']}")
const API_KEY = 'YOUR_API_KEY';
// Get today's due reminders
const payload = {
sortBy: 'REMINDER_TIME_ASC',
limit: 20
};
const response = await fetch(
`https://server.smartlead.ai/api/v1/master-inbox/reminders?api_key=${API_KEY}`,
{
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(payload)
}
);
const result = await response.json();
console.log(`${result.total_count} reminders`);
{
"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 firstREMINDER_TIME_ASC: Earliest/overdue reminders first (recommended for daily review)
Query Parameters
string
required
Your SmartLead API key
Note: This endpoint does NOT support
fetch_message_history parameter (unlike other inbox endpoints)Request Body
number
default:"0"
Pagination offset
number
default:"20"
Records per page (1-20)
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).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}'
import requests
API_KEY = "YOUR_API_KEY"
# Get overdue reminders first
payload = {
"sortBy": "REMINDER_TIME_ASC", # Oldest first
"limit": 20
}
response = requests.post(
"https://server.smartlead.ai/api/v1/master-inbox/reminders",
params={"api_key": API_KEY},
json=payload
)
reminders = response.json()
for msg in reminders.get('messages', []):
print(f"⏰ {msg['lead']['email']} - Reminder: {msg['reminder_time']}")
const API_KEY = 'YOUR_API_KEY';
// Get today's due reminders
const payload = {
sortBy: 'REMINDER_TIME_ASC',
limit: 20
};
const response = await fetch(
`https://server.smartlead.ai/api/v1/master-inbox/reminders?api_key=${API_KEY}`,
{
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(payload)
}
);
const result = await response.json();
console.log(`${result.total_count} reminders`);
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
}