Skip to content

Notifications Journey

A member manages their notification preferences (shown in Account Page) and views their notification feed (shown in Home Dashboard banner).

Sequence Diagram

API Reference

StepServiceMethodPathAuthResponse
Get tokenKeycloakPOST/realms/olly/protocol/openid-connect/tokenNoneaccess_token
Get preferencesnotificationsGET/preferences/{partyLocator}Member JWT200 or 404
Update preferencesnotificationsPUT/preferences/{partyLocator}Member JWT200
List notificationsnotificationsGET/notifications/listMember JWT200 {notifications:[...]}
Notification lognotificationsGET/log/listMember JWT200 {log:[...]}

Notes

  • GET /preferences/{partyLocator} returns 404 if the party has never set preferences — the test skips in this case (requires seeder to have run).
  • Preference field names are camelCase: email, sms, push, claimsUpdates, billingAlerts, enrollmentReminders.
  • GET /preferences (without party locator) also exists and returns preferences for the authenticated user's own party.

Olly Health Insurance Platform