List Subscriptions

Retrieve active webhook subscriptions from the Microsoft Graph API.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/naftiko/microsoft-outlook-sandbox --skill list-subscriptions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: List Subscriptions
Source: https://github.com/naftiko/microsoft-outlook-sandbox/tree/main/skills/list-subscriptions
Command: npx skills add https://github.com/naftiko/microsoft-outlook-sandbox --skill list-subscriptions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users understand and manage the active webhook subscriptions configured for their Microsoft Outlook account, providing visibility into data change notifications.

Core Features & Use Cases

  • View Subscriptions: Retrieve a list of all currently active webhook subscriptions.
  • Monitor Notifications: Understand which resources are being monitored for changes (e.g., new messages).
  • Use Case: A developer needs to check if a webhook subscription for new emails is still active before deploying an update to their notification handler.

Quick Start

List all active webhook subscriptions for the user.

Frequently Asked Questions about List Subscriptions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list active webhook subscriptions for my Outlook mailbox?

To list active webhook subscriptions for an Outlook mailbox, you query the /subscriptions endpoint of the Microsoft Graph API. This retrieves all currently active notification configurations tracking resource changes for your account.

What permissions do I need to retrieve Microsoft Graph webhook subscriptions?

Retrieving Microsoft Graph webhook subscriptions requires an authorization token with the Mail.Read scope. This permission level allows the application to read mailbox data and list active notification hooks configured for the user.

Why would I need to view active webhook subscriptions in Microsoft Outlook?

Viewing active webhook subscriptions helps developers manage and monitor data synchronization systems. It verifies if notifications for specific resources like new messages are still active before deploying updates to notification handlers.

Can I check if a specific new email webhook subscription is still active?

Yes, you can check if a new email webhook subscription is still active by retrieving the list of all active webhook subscriptions. This operation targets the /subscriptions endpoint and shows which resources are currently monitored for changes.

Does listing Outlook webhook subscriptions require any external dependencies?

Listing Outlook webhook subscriptions does not require external dependencies. It operates by querying the Microsoft Graph API directly using an authorization token, providing visibility into active notification systems without additional components.