curl -X POST "https://server.smartlead.ai/api/v1/master-inbox/set-reminder?api_key=YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"email_lead_map_id": 2433664091,
"email_stats_id": "abc-def-123",
"message": "Follow up on pricing question",
"reminder_time": "2025-01-27T14:00:00Z"
}'
import requests
from datetime import datetime, timedelta
API_KEY = "YOUR_API_KEY"
def set_reminder(lead_map_id, email_stats_id, message, days_from_now):
"""Set reminder X days from now"""
reminder_time = (datetime.now() + timedelta(days=days_from_now)).isoformat() + 'Z'
payload = {
"email_lead_map_id": lead_map_id,
"email_stats_id": email_stats_id,
"message": message,
"reminder_time": reminder_time
}
response = requests.post(
"https://server.smartlead.ai/api/v1/master-inbox/set-reminder",
params={"api_key": API_KEY},
json=payload
)
return response.json()
# Remind me in 3 days
set_reminder(
2433664091,
"abc-def-123",
"Follow up on demo feedback",
days_from_now=3
)
const API_KEY = 'YOUR_API_KEY';
async function setReminder(leadMapId, emailStatsId, message, daysFromNow) {
const reminderDate = new Date();
reminderDate.setDate(reminderDate.getDate() + daysFromNow);
const response = await fetch(
`https://server.smartlead.ai/api/v1/master-inbox/set-reminder?api_key=${API_KEY}`,
{
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
email_lead_map_id: leadMapId,
email_stats_id: emailStatsId,
message: message,
reminder_time: reminderDate.toISOString()
})
}
);
return response.json();
}
await setReminder(2433664091, 'abc-def-123', 'Check if interested', 7);
{
"success": true,
"message": "Reminder set successfully",
"data": {
"reminder_id": 789,
"email_lead_map_id": 2433664091,
"reminder_time": "2025-01-27T14:00:00Z",
"message": "Follow up on pricing question"
}
}
Master Inbox
Set Lead Reminder
Set a reminder for a specific lead conversation
POST
/
api
/
v1
/
master-inbox
/
set-reminder
curl -X POST "https://server.smartlead.ai/api/v1/master-inbox/set-reminder?api_key=YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"email_lead_map_id": 2433664091,
"email_stats_id": "abc-def-123",
"message": "Follow up on pricing question",
"reminder_time": "2025-01-27T14:00:00Z"
}'
import requests
from datetime import datetime, timedelta
API_KEY = "YOUR_API_KEY"
def set_reminder(lead_map_id, email_stats_id, message, days_from_now):
"""Set reminder X days from now"""
reminder_time = (datetime.now() + timedelta(days=days_from_now)).isoformat() + 'Z'
payload = {
"email_lead_map_id": lead_map_id,
"email_stats_id": email_stats_id,
"message": message,
"reminder_time": reminder_time
}
response = requests.post(
"https://server.smartlead.ai/api/v1/master-inbox/set-reminder",
params={"api_key": API_KEY},
json=payload
)
return response.json()
# Remind me in 3 days
set_reminder(
2433664091,
"abc-def-123",
"Follow up on demo feedback",
days_from_now=3
)
const API_KEY = 'YOUR_API_KEY';
async function setReminder(leadMapId, emailStatsId, message, daysFromNow) {
const reminderDate = new Date();
reminderDate.setDate(reminderDate.getDate() + daysFromNow);
const response = await fetch(
`https://server.smartlead.ai/api/v1/master-inbox/set-reminder?api_key=${API_KEY}`,
{
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
email_lead_map_id: leadMapId,
email_stats_id: emailStatsId,
message: message,
reminder_time: reminderDate.toISOString()
})
}
);
return response.json();
}
await setReminder(2433664091, 'abc-def-123', 'Check if interested', 7);
{
"success": true,
"message": "Reminder set successfully",
"data": {
"reminder_id": 789,
"email_lead_map_id": 2433664091,
"reminder_time": "2025-01-27T14:00:00Z",
"message": "Follow up on pricing question"
}
}
Schedule reminders for lead follow-ups. Ensures timely responses and prevents leads from going cold.
Overview
Sets a reminder for a specific lead conversation. Reminders trigger email/push notifications at the specified time. Features:- Email/push notifications at reminder time
- Appears in reminders inbox view
- Multiple reminders per lead supported
- Edit or cancel before trigger
Query Parameters
string
required
Your SmartLead API key
Request Body
number
required
Lead-campaign mapping ID
string
required
Specific email/message ID to set reminder for
string
required
Reminder note/description
date
required
Reminder timestamp in ISO 8601 format
curl -X POST "https://server.smartlead.ai/api/v1/master-inbox/set-reminder?api_key=YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"email_lead_map_id": 2433664091,
"email_stats_id": "abc-def-123",
"message": "Follow up on pricing question",
"reminder_time": "2025-01-27T14:00:00Z"
}'
import requests
from datetime import datetime, timedelta
API_KEY = "YOUR_API_KEY"
def set_reminder(lead_map_id, email_stats_id, message, days_from_now):
"""Set reminder X days from now"""
reminder_time = (datetime.now() + timedelta(days=days_from_now)).isoformat() + 'Z'
payload = {
"email_lead_map_id": lead_map_id,
"email_stats_id": email_stats_id,
"message": message,
"reminder_time": reminder_time
}
response = requests.post(
"https://server.smartlead.ai/api/v1/master-inbox/set-reminder",
params={"api_key": API_KEY},
json=payload
)
return response.json()
# Remind me in 3 days
set_reminder(
2433664091,
"abc-def-123",
"Follow up on demo feedback",
days_from_now=3
)
const API_KEY = 'YOUR_API_KEY';
async function setReminder(leadMapId, emailStatsId, message, daysFromNow) {
const reminderDate = new Date();
reminderDate.setDate(reminderDate.getDate() + daysFromNow);
const response = await fetch(
`https://server.smartlead.ai/api/v1/master-inbox/set-reminder?api_key=${API_KEY}`,
{
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
email_lead_map_id: leadMapId,
email_stats_id: emailStatsId,
message: message,
reminder_time: reminderDate.toISOString()
})
}
);
return response.json();
}
await setReminder(2433664091, 'abc-def-123', 'Check if interested', 7);
Response Example
{
"success": true,
"message": "Reminder set successfully",
"data": {
"reminder_id": 789,
"email_lead_map_id": 2433664091,
"reminder_time": "2025-01-27T14:00:00Z",
"message": "Follow up on pricing question"
}
}
Related Endpoints
⌘I
