Skip to main content
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"
  }'

{
  "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

​
api_key
string
required
Your SmartLead API key

​
Request Body

​
email_lead_map_id
number
required
Lead-campaign mapping ID
​
email_stats_id
string
required
Specific email/message ID to set reminder for
​
message
string
required
Reminder note/description
​
reminder_time
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"
  }'

​
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"
  }
}