How can I programmatically access Outlook Newsletter content stored in SharePoint Embedded?

Question

How can I programmatically access Outlook Newsletter content stored in SharePoint Embedded?

Kriti Sharma (Capgemini US LLC) 0 Microsoft External Staff

We are using Outlook Newsletters and would like to automate ingestion of newsletter content into SharePoint/Copilot Studio.

We discovered newsletter editions are stored in SharePoint Embedded and the Outlook web client retrieves newsletter sections and HTML through backend APIs.

Is there a supported API, Microsoft Graph endpoint, SharePoint Embedded access pattern, or Power Automate connector for retrieving newsletter edition content?

0 comments

1 answer

Your answer

Answer 1

Ana Le 2,345 Independent Advisor

Hi,

According to the current Microsoft documentation, Outlook Newsletters stores newsletter editions, including draft and published versions, in SharePoint Embedded containers.

However, I couldn’t find a documented Microsoft Graph endpoint or API specifically for retrieving Outlook Newsletter editions, sections, or the HTML representation used by the Outlook web client. The backend APIs observed by the client should not be treated as supported public APIs.

SharePoint Embedded does provide Microsoft Graph APIs for accessing containers and their driveItem content, but access requires the application to be authorized for the corresponding SharePoint Embedded container type. Therefore, the standard SharePoint Embedded APIs cannot be assumed to provide access to Outlook Newsletters containers simply because the content is stored in SharePoint Embedded.

There is also a SharePoint Embedded connector for Power Automate/Copilot Studio, but the documented connector capabilities are for SharePoint Embedded storage and do not currently expose a Newsletter-specific operation for retrieving Outlook Newsletter editions or their HTML content.

If your requirement is to ingest the published newsletter, an alternative supported approach is to retrieve the generated newsletter email from the relevant mailbox using the Microsoft Graph Mail API. Microsoft documents that published newsletter editions generate email messages, with copies available in recipients’ mailboxes and in the sender’s Sent Items folder.

For reference:

At this time, I would not recommend relying on the Outlook web client’s internal/backend newsletter APIs for an automated ingestion solution, as they are not documented as supported public APIs.

Kriti Sharma (Capgemini US LLC) 0 Reputation points Microsoft External Staff

2026-08-10T06:16:54.47+00:00

Outlook Newsletters content is stored in SharePoint Embedded containers. Is there a supported way for a tenant application to access the Outlook Newsletters SharePoint Embedded container and its driveItems?
Ana Le 2,345 Reputation points Independent Advisor

2026-08-10T12:59:53.3933333+00:00
Yes, SharePoint Embedded containers can be accessed programmatically through Microsoft Graph. However, access is controlled by the container type and the permissions granted to the application. Having access to the tenant or knowing the container ID alone does not grant an application access to the container or its driveItems.

For a SharePoint Embedded application, the application needs the appropriate Microsoft Graph FileStorageContainer.Selected permission, and the application must also be registered/granted the required permissions for the relevant container type.

You can refer to Microsoft's documentation here:

Plan authentication and permissions | Microsoft Learn

Configure authentication and authorization | Microsoft Learn

For Outlook Newsletters specifically, Microsoft documents that newsletter editions and related content are stored in SharePoint Embedded containers: Manage Outlook Newsletters | Microsoft Learn

However, I could not find Microsoft documentation describing a supported mechanism for a separate tenant application to register against the Outlook Newsletters container type and access those containers and their driveItems through the SharePoint Embedded APIs.

The SharePoint Embedded permission model is based on the application being registered for the relevant container type: Register application permissions | Microsoft Learn

Therefore, I would not assume that a tenant application can directly access the underlying Outlook Newsletters containers simply because the containers are located within the tenant or their IDs can be obtained. At this time, I don't see a Microsoft-documented supported integration path for a separate tenant application to access the Outlook Newsletters SharePoint Embedded containers and their driveItems.

If Microsoft introduces a supported API or registration mechanism specifically for accessing Outlook Newsletters content, that would need to be documented for this scenario.
Ana Le 2,345 Reputation points Independent Advisor

2026-08-11T04:09:59.64+00:00

Hi, may I know if you have any chance to check my answer? I am glad to help if you have any other questions.