# Reminders

<p class="doc-lead">CRM Reminders schedule follow-up calls, meetings, tasks, and custom actions linked to a lead, customer, or opportunity. Assign reminders to users, set notify-before alerts, and track completion with check-in for field meetings.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Getting started</span>
<div class="doc-toc-links">
<a href="#/crm/crm-reminder?id=overview">Overview &amp; List View</a>
<a href="#/crm/crm-reminder?id=my-tasks-inbox">My Tasks Inbox</a>
<a href="#/crm/crm-reminder?id=quick-start">Quick Start</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Form reference</span>
<div class="doc-toc-links">
<a href="#/crm/crm-reminder?id=owner-fields">Owner</a>
<a href="#/crm/crm-reminder?id=reminder-fields">Reminder Fields</a>
<a href="#/crm/crm-reminder?id=meeting-location">Meeting Location</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">More</span>
<div class="doc-toc-links">
<a href="#/crm/crm-reminder?id=actions-state">Actions &amp; State</a>
<a href="#/crm/crm-reminder?id=check-in-out">Check In &amp; Check Out</a>
<a href="#/crm/crm-reminder?id=snooze">Snooze</a>
<a href="#/crm/crm-reminder?id=notifications">Notifications</a>
<a href="#/crm/crm-reminder?id=view-tabs">View Tabs</a>
<a href="#/crm/crm-reminder?id=embedded-list">Embedded Reminder List</a>
<a href="#/crm/crm-reminder?id=faq">FAQ</a>
<a href="#/crm/crm-reminder?id=related">Related &amp; Videos</a>
</div>
</div>
</div>

<hr class="doc-section-divider">

<h2 id="overview">Overview &amp; List View</h2>

Go to <b>CRM → Reminders</b> from the left menu. The list shows all CRM reminders with type, owner, assignee, due date, state, and priority.

<!-- screenshot pending: crm/images/crm-reminder-list.webp -->

<b>List columns</b>

| **Column** | **Shows** |
|------------|-----------|
| Id | Reminder reference number. |
| Title | Reminder title. |
| Type | Call, Meeting, Follow Up, Task, or Custom. |
| Lead | Linked lead company. |
| Customer | Linked customer name. |
| Opportunity | Linked opportunity number. |
| Assigned to | User assigned to complete the reminder. |
| Due at | Due date and time. |
| State | pending, snoozed, inProgress, done, cancelled. |
| Priority | Low, Normal, or High. |
| Status | Active or Suspended (entity status). |

<b>Quick filter tabs</b>

Pending, In Progress, Snoozed, Done

<b>Advanced Filters</b>

Title, Type, State, Priority, Assigned to, Lead, Customer, Opportunity, Due Date, and Created Date.

Who appears in the list depends on the signed-in user. A company admin with no <a href="#/settings/user-management?id=employee-data-filters">employee data filter</a> sees every reminder. A user with an employee data filter sees reminders assigned to or created by the users linked to those employees, plus their own. The filter is the employee list, the default Employee when <b>Data filter</b> is on, and advanced employee filters whose module is blank or CRM. Everyone else sees reminders assigned to them or created by them.

<b>List row actions</b>

view, edit, delete

Deleting confirms: <i>This will permanently delete the selected reminders and cancel their scheduled notifications.</i>

<hr class="doc-section-divider">

<h2 id="my-tasks-inbox">My Tasks Inbox</h2>

<b>My Tasks</b> is a personal inbox of reminders assigned to the logged-in user. Route: <b>CRM → Reminders → My Tasks inbox</b> (same permission as <a href="#/crm/reports/my-tasks-report">My Tasks Report</a>). There is no separate left-nav item — access via direct URL or the report permission.

<b>My Tasks list differences</b>

<ul>
<li>Reminders assigned to the users in scope. A company admin with no employee data filter sees every reminder. Anyone else sees reminders assigned to the users in their employee data filter, plus their own. Created-by is not included here.</li>
<li><b>Assigned to</b> column omitted</li>
<li>Row actions: done, snooze, edit, view</li>
<li>Quick filters: Open (pending + inProgress + snoozed), Pending, In Progress, Snoozed, Done</li>
<li><b>New</b> defaults Assigned to to current user</li>
<li><b>Refresh</b> button enabled</li>
</ul>

For a report-style view with KPI cards, export, and print, use <a href="#/crm/reports/my-tasks-report">My Tasks Report</a>.

<hr class="doc-section-divider">

<h2 id="quick-start">Quick Start — Schedule a Reminder</h2>

<h3>1. Navigate</h3>
Go to <b>CRM → Reminders</b> and click <b>New</b>. You can also schedule from a lead, customer, or opportunity view using the more menu or REMINDERS tab.

<h3>2. Select owner</h3>
Choose exactly one of <b>Lead</b>, <b>Customer</b>, or <b>Opportunity</b>.

<h3>3. Set reminder details</h3>
Select Type, Title, Due at, Priority, Assigned to, and Notify before options.

<h3>4. Save</h3>
Click <b>Save</b>. In-app notifications fire according to Notify before settings.

<hr class="doc-section-divider">

<h2 id="owner-fields">Owner</h2>

Exactly one owner is required.

| **Field** | **Description** |
|-----------|-----------------|
| Lead | Active lead. Locked when opened from a lead view. |
| Customer | Active customer. Locked when opened from a customer view. |
| Opportunity | Approved or Closed opportunity. Use <b>Select opportunity</b> picker. Locked when opened from an opportunity view. |

<hr class="doc-section-divider">

<h2 id="reminder-fields">Reminder Fields</h2>

| **Field** | **Required** | **Description** |
|-----------|--------------|-----------------|
| Type | Yes | Call, Meeting, Follow Up, Task, Custom. Default: Task. |
| Title | Yes | Short description of the reminder. |
| Due at | Yes | Date and time the reminder is due. |
| Scheduled end | No | End time. Shown only when Type = Meeting. |
| Priority | No | Low, Normal, High. Default: Normal. |
| Assigned to | No | User who should complete the reminder. Default on My Tasks: current user. |
| Notify before | No | Multi-select: 1 day before, 4 hours before, 1 hour before, 30 min before, 15 min before, At time. Default: At time. |
| Notes | No | Rich-text notes. |

<hr class="doc-section-divider">

<h2 id="meeting-location">Meeting Location</h2>

Shown only when Type = <b>Meeting</b>.

| **Field** | **Description** |
|-----------|-----------------|
| Location name | Name of the meeting site. |
| Latitude | Meeting site latitude. |
| Longitude | Meeting site longitude. |

Used for geofence validation on check-in when coordinates are set.

<hr class="doc-section-divider">

<h2 id="actions-state">Actions &amp; State</h2>

<h3>State lifecycle</h3>

| **State** | **Meaning** |
|-----------|-------------|
| pending | Default on create. |
| inProgress | After meeting check-in. |
| snoozed | User snoozed; fires again at snoozed until. |
| done | Marked done or meeting check-out. |
| cancelled | Manually cancelled. |

<h3>Entity status</h3>

Separate from state: <b>Active</b> or <b>Suspended</b> via Activate or Suspend in the more menu.

<h3>Toolbar and more menu (view page)</h3>

| **Action** | **What it does** |
|------------|------------------|
| Edit | Opens Edit Reminder. |
| Delete | Deletes reminder and cancels scheduled notifications. |
| Mark Done | Sets state to done. |
| Snooze | Opens Snooze modal. |
| Check In | Opens Check In modal (meeting type; lead-linked reminders in UI). |
| Check Out | Opens Check Out modal (meeting type, after check-in). |
| Cancel | Sets state to cancelled. |
| Activate / Suspend | Toggles entity Active/Suspended status. |
| Print | Print view. |

<hr class="doc-section-divider">

<h2 id="check-in-out">Check In &amp; Check Out</h2>

Available for <b>Meeting</b> type reminders. In the UI, Check In and Check Out actions and the MEETING check-in/out display are shown for <b>lead-linked</b> reminders only — they are hidden for Customer- and Opportunity-linked reminders.

<h3>Check In modal</h3>

| **Field** | **Required** | **Description** |
|-----------|--------------|-----------------|
| Latitude | Yes | GPS latitude. Auto-filled via Locate me on open. |
| Longitude | Yes | GPS longitude. |
| Notes | No | Rich-text notes. |

<b>Check In</b> sets state to inProgress and records coordinates. If the current location is too far from the meeting site, check-in is rejected.

<h3>Check Out modal</h3>

Same fields as Check In. <b>Check Out</b> sets state to done and records checkout data. For lead-linked reminders, a lead log entry is written on check-out.

<hr class="doc-section-divider">

<h2 id="snooze">Snooze</h2>

<b>Snooze Reminder</b> modal:

| **Field** | **Description** |
|-----------|-----------------|
| Snooze until | Date and time to defer the reminder. Default: 30 minutes from now. Must be in the future. |

<b>Quick Snooze</b> presets: +15m, +30m, +1h, +4h, +1d, +3d, +7d, +1mo, +3mo, +6mo, +1y

Snooze reschedules the next notification to the snooze time.

<hr class="doc-section-divider">

<h2 id="notifications">Notifications</h2>

When a reminder is saved or updated:

<ol>
<li>The earliest future <b>Notify before</b> offset is calculated from Due at.</li>
<li>An in-app notification is scheduled for that time.</li>
<li>When it fires, the assignee receives a bell notification.</li>
<li>If more notify-before times remain, the next offset is scheduled automatically.</li>
<li>Mark done, check-out, delete, or suspend cancels pending notification jobs.</li>
</ol>

Notifications are in-app only. View scheduled times on the NOTIFICATIONS tab: Notify before, Next fire at, Last fired at.

<hr class="doc-section-divider">

<h2 id="view-tabs">View Tabs</h2>

| **Tab** | **Content** |
|---------|-------------|
| GENERAL | Due at, Scheduled end, State, Priority, Type, Lead, Customer, Opportunity, Created by, Assigned to, Completed at, Snoozed until, Notes. |
| NOTIFICATIONS | Notify before, Next fire at, Last fired at. |
| MEETING | Location, Meeting Latitude, Meeting Longitude, Check-in / Check-out blocks (lead-linked only in UI). |
| History | System audit log. |

<hr class="doc-section-divider">

<h2 id="embedded-list">Embedded Reminder List</h2>

Lead, Customer, and Opportunity views include an embedded reminder list.

<b>Toolbar:</b> Call, Meeting, Reminder (schedule buttons)

<b>Row actions:</b> Mark Done, Snooze, Edit, Delete

Empty state on lead view: <b>No reminders for this lead yet.</b>  
Empty state on embedded widget: <b>No reminders yet.</b>

The <a href="#/sales/customers">Customer</a> view in Sales also includes a REMINDERS tab with the same embedded widget.

On <a href="#/crm/opportunity">Opportunity</a>, the <b>Reminders</b> tab appears in the top sidebar panel (with Secondary Status). You can also schedule from the more menu or accept the follow-up prompt when saving with a Next Contact Date.

<hr class="doc-section-divider">

<h2 id="faq">FAQ</h2>

<p><b>Can I check in on a customer-linked meeting reminder?</b><br>
Check In and Check Out buttons are hidden in the UI for Customer- and Opportunity-linked reminders. Use lead-linked meeting reminders for field check-in, or mark the reminder done manually.</p>

<p><b>Who sees all reminders vs only their own?</b><br>
A company admin with no employee data filter sees every reminder on the Reminders list, and My Tasks lists every reminder in the date range. With an employee data filter, both screens are limited to the users linked to those employees, plus the signed-in user. The Reminders list includes reminders those users created. My Tasks includes only reminders assigned to them. A user with no employee filter who is not a company admin sees reminders assigned to them or created by them on the Reminders list, and only reminders assigned to them on My Tasks.</p>

<p><b>What happens when I delete a lead with reminders?</b><br>
Lead deletion removes associated reminders and cancels their notification jobs first.</p>

<p><b>What reminder types are available?</b><br>
Call, Meeting, Email, Task, and Other — select type when creating a reminder from the form or lead/opportunity/customer more menu.</p>

<p><b>How does Notify Before work?</b><br>
Schedule an advance notification at the chosen interval before the due date/time. The firing job is rescheduled when you snooze or edit the reminder.</p>

<p><b>What is the difference between Reminders list and My Tasks inbox?</b><br>
The main Reminders list supports full CRUD for permitted users. My Tasks inbox is a focused view with Done and Snooze row actions — see also <a href="#/crm/reports/my-tasks-report">My Tasks Report</a>.</p>

<p><b>Can field users snooze reminders in the app?</b><br>
Yes. Field Sale App users with CRM access can Snooze, Done, and Check In on lead-linked meeting reminders per <a href="#/field-sale-app/leads">Field Sale App — Leads</a>.</p>

<p><b>Where are reminders shown on a lead, customer, or opportunity?</b><br>
Lead and Customer views include a <b>REMINDERS</b> tab. Opportunity view includes a <b>Reminders</b> sidebar tab. You can also use Schedule Call / Meeting / Reminder or View Reminders from the more menu.</p>

<p><b>Are email and WhatsApp sent from reminders?</b><br>
In-app notifications use the CRM reminder firing queue. Outbound WhatsApp/email requires separate <a href="#/settings/notification-transaction-configs">Notification Transaction Configs</a> — not configured on the reminder form itself.</p>

<hr class="doc-section-divider">

<h2 id="related">Related &amp; Videos</h2>

<ul>
<li><a href="#/crm/lead">Leads</a></li>
<li><a href="#/crm/opportunity">Opportunity</a></li>
<li><a href="#/sales/customers">Customers</a></li>
<li><a href="#/crm/reports/my-tasks-report">My Tasks Report</a></li>
<li><a href="#/crm/crm-dashboard">CRM Dashboard</a></li>
<li><a href="#/field-sale-app/reports">Field Sale App — My Tasks</a></li>
</ul>

<section class="ai-index-only">

## Errors and warnings

Exact messages for CRM Reminder from the ERP screen and `fs_api`. Visitors do not see this section; Vertex AI Search uses it to answer questions about on-screen errors.


### Type, due date, and exactly one owner

- **Type:** Error
- **Action:** Save
- **When:** Type or Due at is empty, or Lead/Customer/Opportunity is not exactly one.
- **Example message:** *reminderType is required*; *dueAt is required*; *leadId or customerId or opportunityId is required (exactly one)*; ERP: *Exactly one of Lead / Customer / Opportunity must be selected*
- **Outcome:** Not saved.
- **Solution:** Set type, due date, and exactly one owner.
### Schedule and notify offsets

- **Type:** Error
- **Action:** Save
- **When:** Scheduled end is not after Due at, or notify offsets are negative.
- **Example message:** *scheduledEnd must be after dueAt*; *notifyBeforeMinutes values must be non-negative integers*; ERP: *Scheduled end must be after Due at*
- **Outcome:** Not saved.
- **Solution:** Set Scheduled end after Due at and use non-negative notify minutes.
### Check-in / check-out

- **Type:** Error
- **Action:** Check-in, Check-out, Snooze
- **When:** Not a meeting, already checked in/out, too far from the site, or snooze is in the past.
- **Example message:** *Check-in only allowed for meeting reminders*; *Already checked in*; *Cannot check out before checking in*; *Current location is too far from the meeting site*; *snoozedUntil must be in the future*; *latitude is required*
- **Outcome:** The action is rejected.
- **Solution:** Use meeting reminders, check in first, stay at the site, and snooze to a future time.

</section>
