🚧 The `notifications_settings` query is only available in API versions 2025-10 and later

monday.com notifications play a key role in alerting users to important account activity. They are customizable and can be managed in the platform's notifications settings section.

Queries

You can retrieve notifications settings data via the API through the notifications_settings query.

Returns metadata about a user's notification settings
Can only be queried at the root; cannot be nested within another query

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"
  }
}

Arguments

You can use the following arguments to reduce the number of results returned in your notifications_settings query.

Argument	Description	Enum Values
channels `[ChannelType!]`	The notification channel type to filter by.	`Email` `Monday` `Slack`
scope_id `Int`	The unique identifier of the user to retrieve results for. Must be used with the `User` scope type argument. The default is the current signed-in user.
scope_type `ScopeType!`	The notification settings scope types to filter by.	`AccountNewUserDefaults` `User` (user's private settings)
setting_kinds `[String!]`	The name of the notification settings type to filter by.

Fields

You can use the following fields to specify what information your notifications_settings query will return. Some fields will have their own supported subfields.

Field	Description	Supported Subfields
channels `[NotificationSettingChannel!]!`	The available channels for the notification setting.	editable_status `ChannelEditableStatus` enabled `Boolean` name `ChannelType`
description `String`	The notification settings description.
is_for_admins_only `Boolean`	Whether the notification setting is only configurable by admins.
is_for_non_guests_only `Boolean`	Whether the notification setting is only for non-guests.
kind `String`	The notification settings kind.