list_notifications

Read the notification centre of the creator the token acts for — every alert sent to them, newest first, with its class, where it points and whether it was read.

Purpose

Answer "what has happened on my account that I have not looked at?". The Notifications Center is the sidebar entry with its unread count and the page at /notifications: every alert Subscriby sent the creator (a sale, a support backlog, a bot or channel that went silent, a billing or security notice, a pass window, an onboarding nudge). Each row is the same object GET /v1/me/notifications returns; meta.unread says how many are unread in all.

Required ability

account:read

Input schema

{
  "type": "object",
  "properties": {
    "unread": { "type": "boolean", "description": "true for entries not yet read, false for entries already read; omit for every entry." },
    "class": { "type": "string", "enum": ["sales", "support", "recovery", "billing", "security", "passes", "onboarding"], "description": "One class of alert, or omit for every class." },
    "query": { "type": "string", "description": "Words a title or body must contain; omit for every entry." },
    "limit": { "type": "integer", "minimum": 1, "maximum": 100, "description": "Entries per page (default 25)." },
    "page": { "type": "integer", "minimum": 1, "description": "1-indexed page number." }
  }
}

Output shape

{
  "data": [
    {
      "id": "0b1f6e2a-7c3d-4e5f-8a9b-0c1d2e3f4a5b",
      "class": "support",
      "class_label": "Support",
      "title": "Support backlog in Signals",
      "body": "Three members are waiting for an answer.",
      "route": "projects.inbox",
      "params": { "projectId": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13" },
      "url": "https://app.subscriby.net/projects/7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13/inbox",
      "read": false,
      "read_at": null,
      "created_at": "2026-09-12T10:05:30Z"
    }
  ],
  "meta": { "page": 1, "limit": 25, "total": 1, "has_more": false, "unread": 1 }
}

Example prompts

"Anything I should look at? Show me my unread notifications."

"List the recovery notifications from this week."

Failure modes

AUTHENTICATION_REQUIRED — no authenticated user on the request.
TOKEN_MISSING_ABILITY — token lacks account:read.
VALIDATION_FAILED — class is not one of the seven classes.

mark_notification_read — clear one entry.
mark_all_notifications_read — clear the backlog.
get_me — the creator, with unread_notifications.
Notifications API