Skip to content
Beeper Developer Docs
Download Beeper
API Reference
Chats
Reminders

Create a chat reminder

chats.reminders.create(strchat_id, ReminderCreateParams**kwargs)
POST/v1/chats/{chatID}/reminders

Set a reminder for a chat at a specific time.

ParametersExpand Collapse
chat_id: str

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

reminder: Reminder

Reminder configuration

remind_at: Union[str, datetime]

Timestamp when the reminder should trigger.

formatdate-time
dismiss_on_incoming_message: Optional[bool]

Cancel reminder if someone messages in the chat

Create a chat reminder

import os
from datetime import datetime
from beeper_desktop_api import BeeperDesktop

client = BeeperDesktop(
    access_token=os.environ.get("BEEPER_ACCESS_TOKEN"),  # This is the default and can be omitted
)
client.chats.reminders.create(
    chat_id="!NCdzlIaMjZUmvmvyHU:beeper.com",
    reminder={
        "remind_at": datetime.fromisoformat("2025-08-31T23:30:12.520")
    },
)
Returns Examples