Skip to content

Notifications Overview

Sosyabot emits a notification when something happens that you might want to act on — a post failed, a payment was rejected, a teammate accepted an invite, your trial is ending. Each notification fans out across the channels you've enabled.

Endpoints

GET  /api/v1/notifications              list
POST /api/v1/notifications/:id/read     mark single read
POST /api/v1/notifications/read-all     mark every notification read

Storage

typescript
{
  id: number,
  user_id: number,
  recipient_id: string,            // indexed for inbox queries
  source: "auto" | "manual",       // auto = system, manual = admin broadcast
  type: number | string,
  message: string | null,
  url: string | null,              // deep link
  read_at: Date | null,
}

Channels

In-app, email, and push (where supported). Configure per-event toggles in Preferences.