added
New `notifications_settings` object
September 17th, 2025
🏷️ API version:
2025-10
You can now read a user's notification settings across all channels with the notifications_settings
object.
query {
notifications_settings(
channels: [Email, Slack]
scope_type: AccountNewUserDefaults
) {
kind
description
is_for_admins_only
is_for_non_guests_only
channels {
name
enabled
editable_status
}
}
}
{
"data": {
"notifications_settings": [
{
"kind": "invitation",
"description": "Invitations to workspace, board, doc, item, or team",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "notify_auth_domain_signup",
"description": "Signed up with an email address from my account domain",
"is_for_admins_only": true,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "ask_for_permissions",
"description": "Requests access to boards & dashboards",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "invitation_requests_admins_reminder_setting",
"description": "Pending invite requests when invite requests have been pending for over 7 days",
"is_for_admins_only": true,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "mention",
"description": "Mentioned me in an update or reply",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": true,
"editable_status": "Editable"
}
]
},
{
"kind": "notify_invitee_join",
"description": "Signed up after I have invited them",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "dlp_file_deleted_setting",
"description": "File has been deleted for breaching data policies",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "new_post_on_owned_item",
"description": "Wrote an update on an item I own",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "like_your_post",
"description": "Reactions to my update",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "daily_digest",
"description": "My highlights",
"is_for_admins_only": false,
"is_for_non_guests_only": true,
"channels": [
{
"name": "Email",
"enabled": false,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "dlp_update_deleted_setting",
"description": "Update has been deleted or redacted for breaching data policies",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "request_to_install_and_purchase_apps",
"description": "Requests installation to install & purchase apps",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "notify_invitee_didnt_join",
"description": "Didn’t sign up after I have invited them",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "assign",
"description": "Assigned me to an item",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": true,
"editable_status": "Editable"
}
]
},
{
"kind": "new_post_on_subscribed_item",
"description": "Wrote an update on an item I’m subscribed to",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "automation",
"description": "Automations via an automation",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "api",
"description": "Platform API custom notifications using the GraphQL API",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "automation_product",
"description": "Automations with a \"notify\" step this does not include \"send an email\" automations",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "reply_your_reply",
"description": "Replied to a thread I commented on or reacted to",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "automation_system",
"description": "Automation failures when automations don’t run as expected",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "reply_your_post",
"description": "Replied to an update I wrote",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": true,
"editable_status": "Editable"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
},
{
"kind": "template_update",
"description": "Template changes by the template owner",
"is_for_admins_only": false,
"is_for_non_guests_only": false,
"channels": [
{
"name": "Email",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
},
{
"name": "Slack",
"enabled": false,
"editable_status": "AllRelatedNotificationsDontHaveChannel"
}
]
}
]
},
"extensions": {
"request_id": "YOUR_REQUEST_ID"
}
}