Overview

Remindy is a smart reminder service that delivers timely notifications via email and browser push notifications. The service automatically triggers reminders 15 minutes before your scheduled events, ensuring you never miss important dates, meetings, or tasks. Built with security best practices, Remindy integrates seamlessly with web applications through push subscription management and flexible reminder scheduling.

Remindy supports multiple notification channels including email and browser push notifications, with full timezone awareness. Users can create, manage, and delete reminders while maintaining complete control over their notification preferences. The service uses the Web Push Protocol (VAPID) for secure browser notifications, making it ideal for productivity applications, event management systems, and personal scheduling tools.

Whether you're building a project management platform, calendar application, or task tracking system, Remindy provides a reliable backend for user notification management with minimal integration overhead.

Usage

Create a Reminder

POST /api/reminders/create

{
  "userId": 12345,
  "title": "Team Meeting",
  "description": "Quarterly planning session with stakeholders",
  "remindAt": "2025-01-15T14:00:00",
  "timezone": "America/New_York",
  "channel": "email",
  "notifyEmail": "john.doe@example.com"
}

Response:

{
  "success": true,
  "reminderId": "reminder_abc123xyz",
  "message": "Reminder created successfully",
  "scheduledFor": "2025-01-15T14:00:00"
}

List Reminders

POST /api/reminders/list

{
  "userId": 12345
}

Response:

{
  "reminders": [
    {
      "reminderId": "reminder_abc123xyz",
      "title": "Team Meeting",
      "description": "Quarterly planning session with stakeholders",
      "remindAt": "2025-01-15T14:00:00",
      "timezone": "America/New_York",
      "channel": "email",
      "status": "active",
      "createdAt": "2025-01-10T09:30:00"
    },
    {
      "reminderId": "reminder_def456uvw",
      "title": "Project Deadline",
      "description": null,
      "remindAt": "2025-01-20T17:00:00",
      "timezone": "UTC",
      "channel": "push",
      "status": "active",
      "createdAt": "2025-01-10T10:15:00"
    }
  ],
  "total": 2
}

Endpoints

Push Notifications

POST /api/push/subscribe

Save or update a user's push subscription for browser notifications.

Parameters:

• userId (integer, required): Unique user identifier
• endpoint (string, required): Browser push service endpoint URL
• p256dh (string, required): Diffie-Hellman public key for encryption
• auth (string, required): Authentication secret for push messages

Response:

{
  "success": true,
  "message": "Push subscription saved"
}

POST /api/push/unsubscribe

Remove a user's push subscription.

Parameters:

• userId (integer, required): Unique user identifier

Response:

{
  "success": true,
  "message": "Push subscription removed"
}

GET /api/push/vapid-public-key

Retrieve the VAPID public key required for client-side push notification setup.

Parameters: None

Response:

{
  "publicKey": "BEX_public_key_base64_encoded_string"
}

POST /api/push/status

Check whether a user has an active push subscription.

Parameters:

• userId (integer, required): Unique user identifier

Response:

{
  "userId": 12345,
  "subscribed": true,
  "endpoint": "https://...",
  "subscribedAt": "2025-01-10T08:30:00"
}

Reminders

POST /api/reminders/create

Create a new reminder with email and/or push notification settings.

Parameters:

• userId (integer, required): Unique user identifier
• title (string, required): Reminder title
• description (string, optional): Detailed description of the reminder
• remindAt (string, required): ISO 8601 datetime when reminder should trigger
• timezone (string, optional, default: "UTC"): IANA timezone identifier
• channel (string, optional, default: "email"): Notification channel ("email" or "push")
• notifyEmail (string, optional): Email address for notification (required if channel is "email")

Response:

{
  "success": true,
  "reminderId": "reminder_abc123xyz",
  "scheduledFor": "2025-01-15T14:00:00"
}

POST /api/reminders/list

Retrieve all reminders for a specific user.

Parameters:

• userId (integer, required): Unique user identifier

Response:

{
  "reminders": [
    {
      "reminderId": "string",
      "title": "string",
      "description": "string or null",
      "remindAt": "string (ISO 8601)",
      "timezone": "string",
      "channel": "string",
      "status": "string",
      "createdAt": "string (ISO 8601)"
    }
  ],
  "total": 0
}

POST /api/reminders/delete

Delete a reminder by ID.

Parameters:

• reminderId (string, required): Unique reminder identifier
• userId (integer, required): Unique user identifier

Response:

{
  "success": true,
  "message": "Reminder deleted successfully"
}

Health & Status

GET /

Root endpoint returning service information.

Response:

{
  "service": "Remindy",
  "version": "2.0.0",
  "status": "operational"
}

GET /health

Health check endpoint for monitoring service availability.

Response:

{
  "status": "healthy",
  "timestamp": "2025-01-10T12:00:00Z"
}

Pricing

About

ToolWeb.in - 200+ security APIs, CISSP & CISM, platforms: Pay-per-run, API Gateway, MCP Server, OpenClaw, RapidAPI, YouTube.

• toolweb.in
• portal.toolweb.in
• hub.toolweb.in
• toolweb.in/openclaw/
• rapidapi.com/user/mkrishna477
• youtube.com/@toolweb-009

References

• Kong Route: https://api.toolweb.in/tools/remindy
• API Docs: https://api.toolweb.in:8198/docs