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

Create a chat reminder

client.chats.reminders.create(stringchatID, ReminderCreateParams { reminder } body, RequestOptionsoptions?): void
POST/v1/chats/{chatID}/reminders

Set a reminder for a chat at a specific time.

ParametersExpand Collapse
chatID: string

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

body: ReminderCreateParams { reminder }
reminder: Reminder

Reminder configuration

remindAt: string

Timestamp when the reminder should trigger.

formatdate-time
dismissOnIncomingMessage?: boolean

Cancel reminder if someone messages in the chat

Create a chat reminder

import BeeperDesktop from '@beeper/desktop-api';

const client = new BeeperDesktop({
  accessToken: process.env['BEEPER_ACCESS_TOKEN'], // This is the default and can be omitted
});

await client.chats.reminders.create('!NCdzlIaMjZUmvmvyHU:beeper.com', {
  reminder: { remindAt: '2025-08-31T23:30:12.520Z' },
});
Returns Examples