---
title: "Create reminder"
method: POST
path: "/reminders"
tags: ["Reminders"]
---

# Create reminder

`POST /reminders`

## Request

- Base URL: `https://api.caliuapp.com`
- URL: `https://api.caliuapp.com/reminders`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `caliu_session`

Create a reminder for a note. Multiple reminders per note are supported.

## Request body

- object
  - `id` string: Client-provided ID for offline-created reminders
  - `noteId` string, required: Note ID to attach the reminder to
  - `triggerAt` string, date-time, required: ISO 8601 datetime when the reminder should fire
  - `recurrence` string: RRULE string for recurring reminders (e.g. FREQ=DAILY)

## Response `201`

Reminder created

- object
  - `reminder` Reminder, required
    - `id` string, required
    - `noteId` string, required
    - `triggerAt` string, required
    - `recurrence` string, nullable, required
    - `snoozedUntil` string, nullable, required
    - `firedAt` string, nullable, required
    - `dismissedAt` string, nullable, required
    - `createdAt` string, required
    - `updatedAt` string, required

## Other responses

- `404`: Note not found

---

[API](https://skmtc.dev/caliuapp/apis/caliu-api.md) · [All operations](https://skmtc.dev/caliuapp/apis/caliu-api/llms.txt) · [OpenAPI document](https://skmtc.dev/caliuapp/apis/caliu-api/revisions/1ba4d3f687fe?raw)