List Topics
Lists the authenticated user's topic-scoped notification preferences, plus user-agnostic platform defaults. Each filter matches preferences scoped to its value or not narrowed on that dimension. Per-experience levels are listed separately, by GET /users/me/preferences/notifications/experiences.
Query parameters
Only return preferences for this delivery channel (or not narrowed to a channel).
Only return preferences scoped to this account's member notifications (biz_ tag).
Only return preferences scoped to this account's team notifications (biz_ tag).
Only return preferences scoped to this experience (exp_ tag).
Only return preferences scoped to this notification topic (topic_ tag).
The number of preferences to return.
A cursor; returns preferences after this position.
Response
preferences listed
Example response
{
"data": [
{
"created_at": "2026-01-01T12:00:00.000Z",
"id": "unpf_xxxxxxxxxxxxxx",
"level": "all",
"object": "notification_preference",
"scope": {
"account_id": "biz_xxxxxxxxxxxxxx",
"channel": "in_app",
"experience_id": "exp_xxxxxxxxxxxxxx",
"team_account_id": "biz_xxxxxxxxxxxxxx",
"topic_id": "topic_xxxxxxxxxxxxxx"
},
"updated_at": "2026-01-01T12:00:00.000Z"
}
],
"page_info": {
"start_cursor": "WyJjdXJzb3IiLDFd"
}
}Changes
Changed in 3 of the 46 revisions of this API.3
- ○
added the optional property
/to the response with the statusresponse-optional-property-added
This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
- ○
- ○
the security scope
user:notifications:readwas added to the endpoint's security schemebearerAuthapi-security-scope-added
This revision also has 16 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
- ○
- ○
endpoint added
endpoint-added
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
- ○
Of the 46 revisions, 1 has no diff computed.