Create a reminder - Hasta Backend

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).

Notifications per occurrence: you get up to 3 pushes per occurrence, all sharing the same reminder_key - a 10-minutes-before nudge, a 5-minutes-before nudge, and the main alert exactly at reminder_time.

Who it's for: omit family_key for a self reminder, or pass an existing family_key (from GET /users/family) to set it for that family member instead.

Content-aware reminders (library/mantra): to remind a user to listen to a specific piece of content (e.g. "chant Hanuman Chalisa every day"), set reminder_type to library or mantra and reference_slug to that item's slug (from GET /library or GET /mantras) - the notification body then automatically names the real item ("It's time to listen to Hanuman Chalisa...") instead of using your generic description. Any other reminder_type (e.g. puja) is just a free-form label with no special resolution, and reference_slug is ignored.

Request: Bearer token

Body: title, description, reminder_time (HH:MM), timezone, repeat_type (daily|weekly), repeat_days (required for weekly), optional family_key (Family-XXXXX), reminder_type (free-form, or library/mantra for content-aware resolution), reference_slug (the library/mantra item's slug when reminder_type is library/mantra), start_date, end_date

Success: 200 - data is the created reminder (reminder_key, family_key, family_member_name, reminder_type, reference_slug, title, description, reminder_time, timezone, repeat_type, repeat_days, start_date, end_date, is_active, next_trigger_on, last_triggered_on). Also returns 200 with success: false and code: PLAN_LIMIT (not an HTTP error) when header X-Enforce-Paywall: true is sent and active reminders have hit the plan's reminder_limit

Errors: 401 - invalid token | 404 - family_key does not match a family member of this user, or reference_slug does not match an active library/mantra item | 422 - invalid fields (e.g. weekly without repeat_days)

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Free-form reminder for yourselfContent-aware library reminder for yourselfContent-aware mantra reminder for a family member, weekly

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

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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