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

# Create reminder

`POST /v1/reminders`

Creates a new scheduled reminder. Supports one-time and recurring (RRULE) schedules. Maximum 50 active reminders per user.

## Request body

- ReminderCreateDto
  - `title` string
  - `promptText` string
  - `deliveryTextTemplate` string
  - `scheduleType` string
  - `dtStart` integer
  - `timeZone` string
  - `rrule` string

## Response `200`

Reminder created successfully

- ReminderDto
  - `id` string
  - `user` string
  - `lastUpdate` integer
  - `created` integer
  - `title` string
  - `promptText` string
  - `deliveryTextTemplate` string
  - `scheduleType` string
  - `dtStart` integer
  - `timeZone` string
  - `rrule` string
  - `nextFireAt` integer
  - `status` string
  - `lastFiredAt` integer

## Other responses

- `400` — Invalid reminder data provided
- `401` — Not authorized to create reminders

---

[API](https://skmtc.net/timesheet/apis/timesheet-api.md) · [All operations](https://skmtc.net/timesheet/apis/timesheet-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/timesheet/timesheet-api/revisions/fbe59bacb638/schema)