Create a reminder

POST

/api/v1/reminders/

reminders

Last modified:2026-06-04 22:55:16

Create a new reminder for the authenticated user or one of their family members. Supports daily and weekly repeat schedules. The next trigger time is computed automatically from reminder_time and timezone. repeat_days is required when repeat_type is 'weekly' (0=Monday … 6=Sunday).

Request: Bearer token

Body: title, description, reminder_time (HH:MM), timezone, repeat_type (daily|weekly), repeat_days (required for weekly), optional family_key, reminder_type, start_date, end_date

Success: 200 - data is the created reminder (reminder_key, family_member_name, reminder_type, title, description, reminder_time, timezone, repeat_type, repeat_days, start_date, end_date, is_active, next_trigger_on, last_triggered_on).

Errors: 401 - invalid token | 404 - family member not found | 422 - invalid fields (e.g. weekly without repeat_days)

Request

Body Params application/jsonRequired

Example

{
    "description": "Time for your morning puja ritual.",
    "reminder_time": "07:00",
    "reminder_type": "puja",
    "repeat_type": "daily",
    "timezone": "Asia/Kolkata",
    "title": "Daily Puja"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/reminders/' \
--header 'Content-Type: application/json' \
--data '{
    "description": "Time for your morning puja ritual.",
    "reminder_time": "07:00",
    "reminder_type": "puja",
    "repeat_type": "daily",
    "timezone": "Asia/Kolkata",
    "title": "Daily Puja"
}'

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Reminder created",
    "data": {
        "reminder_key": "Remind-83421",
        "reminder_type": "puja",
        "title": "Daily Puja",
        "description": "Time for your morning puja ritual.",
        "reminder_time": "07:00",
        "timezone": "Asia/Kolkata",
        "repeat_type": "daily",
        "is_active": true,
        "next_trigger_on": "2026-05-22T01:30:00Z"
    }
}

🟠401Unauthorized

🟠404Record Not Found

🟠422Parameter Error

Modified at 2026-06-04 22:55:16

Fetch user reminders

Update a reminder