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 identifierendpoint (string, required): Browser push service endpoint URLp256dh (string, required): Diffie-Hellman public key for encryptionauth (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 identifiertitle (string, required): Reminder titledescription (string, optional): Detailed description of the reminderremindAt (string, required): ISO 8601 datetime when reminder should triggertimezone (string, optional, default: "UTC"): IANA timezone identifierchannel (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 identifieruserId (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
| Plan | Calls/Day | Calls/Month | Price |
|---|
| Free | 5 | 50 | Free |
| Developer | 20 | 500 | $39/mo |
| Professional | 200 | 5,000 | $99/mo |
| Enterprise | 100,000 | 1,000,000 | $299/mo |
About
ToolWeb.in - 200+ security APIs, CISSP & CISM, platforms: Pay-per-run, API Gateway, MCP Server, OpenClaw, RapidAPI, YouTube.
References
