API Reference

Chats

Reminders

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Create a chat reminder

POST/v1/chats/{chatID}/reminders

Set a reminder for a chat at a specific time.

Path ParametersExpand Collapse

chatID: string

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

Body ParametersJSONExpand Collapse

reminder: object { remindAt, dismissOnIncomingMessage }

Reminder configuration

remindAt: string

Timestamp when the reminder should trigger.

formatdate-time

dismissOnIncomingMessage: optional boolean

Cancel reminder if someone messages in the chat

Create a chat reminder

HTTP

HTTP

TypeScript

Python

Go

CLI Tool

PHP

curl http://localhost:23373/v1/chats/$CHAT_ID/reminders \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $BEEPER_ACCESS_TOKEN" \
    -d '{
          "reminder": {
            "remindAt": "2025-08-31T23:30:12.520Z"
          }
        }'

Returns Examples