## Create a chat reminder

**post** `/v1/chats/{chatID}/reminders`

Set a reminder for a chat at a specific time.

### Path Parameters

- `chatID: string`

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

### Body Parameters

- `reminder: object { remindAt, dismissOnIncomingMessage }`

  Reminder configuration

  - `remindAt: string`

    Timestamp when the reminder should trigger.

  - `dismissOnIncomingMessage: optional boolean`

    Cancel reminder if someone messages in the chat

### Example

```http
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"
          }
        }'
```