---
title: "Create Reminder"
method: POST
path: "/users/me/reminders"
tags: ["reminders"]
---

# Create Reminder

`POST /users/me/reminders`

## Request body

- CreateReminderRequest — Request model for creating a new reminder
  - `message` string, required — Reminder message content
  - `channel` 'sms' | 'imessage' | 'line' | 'whatsapp' | 'default', nullable — Delivery channel for the reminder
  - `execution_timestamp_iso_datestring` string, nullable — Execution timestamp in ISO format for one-time reminders (e.g., '2024-01-15T14:30:00-05:00')
  - `cron_string` string, nullable — Cron string for recurring reminders, minimum interval of 15 minutes
  - `scheduled_task` boolean — Optional scheduled task identifier associated with the reminder
  - `category` 'health' | 'travel' | 'personal' | 'leisure' | 'work' | 'generic' — Category for the reminder. Valid values: 'health', 'travel', 'personal', 'leisure', 'work', 'generic'. Defaults to 'generic'
  - `task_key` string, nullable — Optional task key to associate reminder with a task (e.g., 'meeting_prep#user@example.com')
  - `creator_org_id` string, nullable — Optional organization ID that created the reminder
  - `creator_user_id` string, nullable — Optional user ID who created the reminder

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

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