schedule_notification
Schedule a one-off notification to be sent at a future date and time. Supports ISO 8601, date+time+timezone, or delay formats.
Instructions
Schedule a one-off notification for a future time.
Supports three input modes (use only one):
datetime: ISO 8601 format (e.g., 2025-01-15T09:00:00+01:00)
date + time + timezone: Separate parameters
delay: QStash delay format (e.g., 1d, 2h30m, 1d10h30m50s)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | Date in YYYY-MM-DD format. Defaults to today if omitted. | |
| time | No | Time in HH:MM format | |
| delay | No | QStash delay format (e.g., "1d", "2h30m", "1d10h30m") | |
| message | Yes | The notification text to send | |
| datetime | No | ISO 8601 datetime with timezone | |
| timezone | No | IANA timezone (required with date+time). Check the user's system timezone first. If unavailable, ask the user for their timezone. Examples: Europe/Warsaw, Europe/London, America/New_York, America/Los_Angeles, Asia/Tokyo, Asia/Shanghai, Australia/Sydney, UTC | |
| notification_topic | Yes | The notification topic to send to. Format: lowercase alphanumeric with dashes (e.g., 'my-alerts', 'user-123-notifications') |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||