reminders

WRITE: set a reminder that arrives as a notification on the traveller's phone at a time they choose — only when THEY ask

WRITE: set a reminder that arrives as a notification on the traveller's phone at a time they choose — only when THEY ask ("remind me at 7 to leave for the ferry"). Give text (≤140 characters; it shows on a locked phone, so no links, e-mails, booking codes or long numbers) and at as an ISO time WITH their UTC offset for where they will be (e.g. 2026-10-20T07:00:00-04:00) — ask if you do not know. Optionally tie it to a trip (tripId) or a saved place (pointId): a tap opens it. Quiet hours delay it rather than drop it; their notification settings still apply. Shown as "Reminder · <your name>".

post/actions/remind_me

Request

  • Base URL: https://findinghorizons.ca/api/v1
  • URL: https://findinghorizons.ca/api/v1/actions/remind_me
  • Auth: OAuth 2 (authorization code, authorization URL https://findinghorizons.ca/api/mcp/authorize, token URL https://findinghorizons.ca/api/mcp/oauth/token, scopes: reminders:write)

Headers

Idempotency-Keystring required

One per intended change; a repeat never runs twice.

X-FH-Taskstring

Your task reference.

Request body

textstring required

What to remind them of, in their language

atstring required

ISO 8601 time with offset, e.g. 2026-10-20T07:00:00-04:00

tripIdstring

Optional: one of their trips (a tap opens it)

pointIdstring

Optional: one of their saved places (a tap opens it)

todaystring

The traveller's own date, YYYY-MM-DD, where the action needs one

expectedVersioninteger

For a change to a trip: the planVersion you last read

Response

Done — { ok, api, action, result, card, operation? }

Changes

No recorded changes to this operation across all 1 revision of this API.