Skip to content

Create a new reminder

POST
/reminders
curl --request POST \
--url http://localhost:8000/api/v1/reminders \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "client_id": "example", "title": "example", "description": "example", "type": "daily_tracking", "trigger_at": "2026-04-15T12:00:00Z", "due_at": "2026-04-15T12:00:00Z", "repeat_rule": "FREQ=DAILY;BYHOUR=20;BYMINUTE=0", "timezone": "UTC", "priority": 1, "metadata": {} }'
Media type application/json
object
client_id
string
title
required
string
description
string
type
string
Allowed values: daily_tracking weekly_review monthly_summary bill_due budget_alert custom
trigger_at
string format: date-time
due_at
string format: date-time
repeat_rule
string
Example
FREQ=DAILY;BYHOUR=20;BYMINUTE=0
timezone
string
Example
UTC
priority
integer
metadata
object

Reminder created successfully

Media type application/json
object
id
integer
title
string
description
string
nullable
type
string
Allowed values: daily_tracking weekly_review monthly_summary bill_due budget_alert custom
trigger_at
string format: date-time
nullable
due_at
string format: date-time
nullable
repeat_rule
string
nullable
timezone
string
status
string
Allowed values: active paused snoozed completed cancelled
priority
integer
snoozed_until
string format: date-time
nullable
last_triggered_at
string format: date-time
nullable
next_trigger_at
string format: date-time
nullable
metadata
object
Example
{
"type": "daily_tracking",
"repeat_rule": "FREQ=DAILY;BYHOUR=20;BYMINUTE=0",
"timezone": "UTC",
"status": "active"
}

Validation error