FreshBooks Bulk Invoice Reminder Sender

WHAT IT DOES

FreshBooks Bulk Invoice Reminder Sender is an accounting and business finance productivity tool that streamlines the process of sending payment reminders to multiple invoices. Instead of manually opening each invoice, clicking the send reminder button, and confirming—a process that can be tedious when managing many invoices—this script automates the entire workflow. It scans the current FreshBooks invoices list page, identifies invoices with their client names, amounts, due dates, and statuses, and presents them as a scrollable checklist. You can select individual invoices, use Select All/Deselect All toggles, add a custom reminder note, and send reminders to your selections in configurable batches. The tool handles the complete interaction sequence: selecting the invoice, locating the send reminder interface (button or bulk action modal), optionally adding a note, and confirming the send. Real-time progress updates show how many reminders have been sent, and the list automatically refreshes after completion. This is ideal for business owners, accountants, freelancers, and finance professionals who need to follow up on outstanding invoices efficiently.

WHERE IT RUNS

This script operates exclusively on FreshBooks (*.freshbooks.com/*) as a userscript injected through the BotGentz extension. It runs within the context of your current browser tab and cannot access other tabs, bookmarks, history, or downloads. The script reads the page DOM to identify invoices using FreshBooks's selectors (.invoice-row, .invoice-item, .list-item), extracts invoice metadata (client, amount, due date, status), and interacts with FreshBooks's native UI controls—send reminder buttons, bulk action modals, and confirm buttons—to send reminders. All operations occur locally in your browser; no data is sent to external servers.

HOW TO USE

1. Navigate to your FreshBooks invoices list page (usually under "Invoices").

2. Click the BotGentz extension icon and select "FreshBooks Bulk Invoice Reminder Sender" from the script list.

3. The panel opens on the right side of the page. It automatically scans the current page for invoices.

4. Review the displayed invoices, showing client names, invoice IDs, amounts, due dates, and statuses.

5. Enter a custom reminder note in the "Reminder note" field (optional).

6. Adjust the "Batch size" number (default 3) to control how many reminders are sent per batch.

7. Toggle "Confirm before each batch" if you want a confirmation popup before each batch executes.

8. Check the boxes next to invoices you wish to send reminders for. Use "Select All" or "Deselect All" for quick selection.

9. Click "Send Reminders" to begin. The script processes invoices in batches, shows progress, and handles errors.

10. After completion, the invoice list automatically refreshes showing your updated reminders.

WHY IT WORKS WHERE OTHERS FAIL

Many FreshBooks automation tools fail because they attempt to call FreshBooks's internal API endpoints or rely on brittle DOM selectors that change with every FreshBooks UI update. This script takes a resilient approach: it locates the actual interactive DOM elements FreshBooks renders—the invoice checkbox, the send reminder button (or bulk action modal), and the confirm button—and triggers native click events and value changes on them, exactly as a human would. When sending a reminder, the script uses multiple selector strategies to find the reminder interface, handles both individual and bulk reminder workflows, optionally sets a custom note using the native value setter and dispatches "input" and "change" events, and confirms the send. Between operations, the script introduces controlled delays (300ms between actions and 500ms between batches) to mimic human interaction speed and avoid triggering FreshBooks's rate limiting. By interacting at the UI layer rather than the framework layer, it remains functional across FreshBooks's frequent code updates.

THE PANEL

The script uses BotGentz's BGPanel system, which provides a floating, draggable panel on the right side of your screen. Drag the panel by its header to reposition it anywhere on the page—the panel remembers its position per site and snaps to the nearest edge when released. Click the minimize button to collapse the panel to a small floating bubble; click the bubble to expand it back. Resize the panel vertically by dragging its bottom edge. Press the Escape key to close the panel entirely. All panel state (position, collapsed/expanded) is persisted locally using GM_setValue, so your preferences survive page reloads.

PLEASE NOTE

This userscript requires the free BotGentz browser extension—it is not a standalone application. FreshBooks periodically updates its website layout and UI components; if the script stops working, an updated version may be released. The script sends reminders for selected invoices; ensure you have reviewed the invoices before sending. This script does not store, transmit, or process any of your FreshBooks data outside your local browser. It does not access your password, hidden inputs, or file inputs. All reminder emails are sent through FreshBooks's own authenticated session using the official user interface. Use responsibly and verify invoice selections before sending reminders.