Notify API reference

Notify API · Recipients

get/v1/workspaces/{workspace_id}/recipients/{external_id}/preferencesAuth

Get a recipient's preferences

The cells the recipient set, unsubscribe-all, time zone and quiet hours. Anything not set follows the category defaults.

Path parameters

workspace_id*string · uuid

Id of the workspace.

external_id*string

Your user id for the recipient (URL-encoded): 1-255 of `A-Z a-z 0-9 . _ : @ | -`.

Response · 200 The preferences.

external_id*string

The recipient external id.

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, else the workspace default. Null: no quiet hours apply.

preferences*array

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

Example

Request

GET https://api.notify.productcraft.co/v1/workspaces/{workspace_id}/recipients/{external_id}/preferences
Authorization: Bearer YOUR_TOKEN

Response

{
  "external_id": "string",
  "unsubscribed_all": false,
  "timezone": "string",
  "quiet_hours": {},
  "effective_quiet_hours": {},
  "preferences": [
    {
      "scope": {},
      "key": "string",
      "channel": {},
      "enabled": false
    }
  ]
}