API Reference

Chats

Reminders

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Create a chat reminder

$ beeper-desktop chats:reminders create

POST/v1/chats/{chatID}/reminders

Set a reminder for a chat at a specific time.

ParametersExpand Collapse

--chat-id: string

Chat ID. Input routes also accept the local chat ID from this installation when available.

--reminder: object { remindAt, dismissOnIncomingMessage }

Reminder configuration

Create a chat reminder

CLI Tool

HTTP

TypeScript

Python

Go

CLI Tool

PHP

beeper-desktop chats:reminders create \
  --access-token 'My Access Token' \
  --chat-id '!NCdzlIaMjZUmvmvyHU:beeper.com' \
  --reminder "{remindAt: '2025-08-31T23:30:12.520Z'}"

Returns Examples