> ## Documentation Index
> Fetch the complete documentation index at: https://api.smartlead.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Set Lead Reminder

> Set a reminder for a specific lead conversation

<Note>
  Schedule reminders for lead follow-ups. Ensures timely responses and prevents leads from going cold.
</Note>

## 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

<ParamField query="api_key" type="string" required>
  Your SmartLead API key
</ParamField>

## Request Body

<ParamField body="email_lead_map_id" type="number" required>
  Lead-campaign mapping ID
</ParamField>

<ParamField body="email_stats_id" type="string" required>
  Specific email/message ID to set reminder for
</ParamField>

<ParamField body="message" type="string" required>
  Reminder note/description
</ParamField>

<ParamField body="reminder_time" type="date" required>
  Reminder timestamp in ISO 8601 format
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  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"
    }'
  ```

  ```python Python theme={null}
  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
  )
  ```

  ```javascript JavaScript theme={null}
  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);
  ```
</RequestExample>

## Response Example

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "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"
    }
  }
  ```
</ResponseExample>

## Related Endpoints

* [Get Reminder Emails](/api-reference/inbox/get-reminders)
* [Create Task](/api-reference/inbox/create-task)