Notify API reference

Notify API · Client

get/v1/client/preferencesAuth

Get my preferences

The workspace's categories with their per-channel defaults (`mandatory` channels cannot be turned off: show them read-only), the cells the recipient set, and their time zone and quiet hours.

Response · 200 The preferences.

categories*array

The workspace's categories in display order, with their defaults.

preferences*array

Cells the recipient set (anything else follows the category defaults).

unsubscribed_all*boolean

Opted out of every non-critical notification.

timezone*string

IANA time zone.

quiet_hours*object

The recipient's own quiet window; null when they set none (the workspace default then applies, see `effective_quiet_hours`).

effective_quiet_hours*object

The quiet window that applies: the recipient's own (`source: recipient`), else the workspace default (`source: workspace`). Null: no quiet hours apply. Show this, not `quiet_hours`, as the current state; setting `quiet_hours` replaces the default for this recipient.

Example

Request

GET https://api.notify.productcraft.co/v1/client/preferences
Authorization: Bearer YOUR_TOKEN

Response

{
  "categories": [
    {
      "key": "billing",
      "name": "string",
      "description": "string",
      "defaults": {}
    }
  ],
  "preferences": [
    {
      "scope": {},
      "key": "string",
      "channel": {},
      "enabled": false
    }
  ],
  "unsubscribed_all": false,
  "timezone": "string",
  "quiet_hours": {},
  "effective_quiet_hours": {}
}