Planning for the SharePoint Connection changes
Microsoft is deprecating the classic SharePoint applications on April 2, 2026 and to get ahead of that we have prepared a comprehensive guide to prepare for the change and implement the new connections. This article will cover all possible scenarios ranging from simple swaps from JungleMail sites tied with SharePoint to standalone JungleMail sites and scenarios which involve content retireval from SharePoint, Archive, etc.
Switching from a JungleMail site associated with SharePoint to a standalone JungleMail site
This step can be skipped if your JungleMail sites are not linked with SharePoint and already standalone JungleMail sites. You can identify such sites by the purple cloud logo next to their name, while SharePoint-associated sites have the green SharePoint logo.
Important
This requires JungleMail Global Administrator permissions and the JungleMail 365 Entra ID app for authentication after the conversion.
Since the JungleMail 365 SharePoint app will be deprecated, JungleMail sites associanted with a SharePoint site will stop functioning as well, as they rely on the SharePoint app for authentication. JungleMail also supports authentication via Microsoft Entra ID app. If that is not provisioned yet, please follow the installation instructions before converting the SharePoint-associated JungleMail sites to standalone JungleMail sites. This will ensure users do not lose access to the application once the sites are converted.
To convert the site from a SharePoint-associated site to a standalone site, navigate to JungleMail Settings > All Sites page.
Important
If you only have one JungleMail site in use, you will need to temporarily create a second site and do the conversion from that site instead. Learn more on how to create a new JungleMail site here.
In there, open the Actions menu next to a SharePoint-associated site and use the Convert to Stand-alone button.
Convert the site via the pop-up window. The site will be converted to a standalone site and will no longer be accessible via the SharePoint app. If people were accessing JungleMail directly via the SharePoint app, please add the appropriate JungleMail URL's as bookmarks or buttons/quick links in SharePoint as an alternative.
Once this is done, the JungleMail 365 SharePoint app can be removed from the SharePoint site. This should be repeated for all SharePoint-associated sites. Users should be instructed not to look for the app in SharePoint anymore.
Configuring SharePoint Content, Archive and SharePoint Subscribers via the JungleMail SharePoint Connection Entra ID App
The JungleMail SharePoint Connection Entra ID App will be used for configuring SharePoint Recipient retrieval, Content Retrieval via Dynamic Content or Item picker, Newsletter Archiving, or managing SharePoint subscribers.
The JungleMail SharePoint Connection Entra ID App can work in two modes; Service Account mode or Selected Sites mode.
The Service Account mode will use a specific service account to perform the content retrieval from SharePoint, newsletter archiving, etc. JungleMail user permissions are not taken into account, as only the service account permissions are used. For example, the JungleMail user will be able to only access the content in SharePoint that the Service Account has access to, regardless of their own permissions. This makes it very easy to provision this model, as the Service Account can be given least-priviledge permissions only to SharePoint Sites or Lists/Libraries where content is being posted and nowhere else.
The Selected Sites mode uses PowerShell to grant the JungleMail SharePoint Connection Entra ID App permissions to specific SharePoint sites. JungleMail App + JungleMail User + specific sites will be taken into account. For example, JungleMail users will only be able to fetch content from a specific SharePoint site if the JungleMail SharePoint Connection app has been granted access to that specific site via PowerShell.
Configuring the JungleMail SharePoint Connection for Recipient retrieval, Item Picker or Dynamic Content
Follow the steps in the articles below based on the method you would like to implement;
JungleMail SharePoint Connection using Service Account
JungleMail SharePoint Connection using Selected Sites mode
Configuring the JungleMail SharePoint Connection for Newsletter Archiving
To update the archiving configuration, you should first activate the SharePoint connection as described above. Once the SharePoint connection is active, you should use the same methods for configuring the archive.
Note: With the current MS Graph API capabilities, there is no way to grant granular permissions to specific lists. Site-level permissions need to be granted for JungleMail instead.
To authorize the archive connection navigate to JungleMail Settings > Archive
In there, configure the archive connection by enabling it. If it was enabled using the legacy SharePoint app, use the Authorize new list button instead.
If you are going with the Service Account option, ensure that the Service Account has Write access to the Archive list.
If you are going with the Selected Sites mode, grant the JungleMail SharePoint Connection app "Write" permissions via the same PowerShell as described in the article above.
Grant-PnPAzureADAppSitePermission -AppId $appId -DisplayName "JM365 Data Writing" -Permissions Write -Site $siteUrl
Configuring the JungleMail SharePoint Connection for SharePoint Subscribers
To update the SharePoint subscriber configuration, you should first activate the SharePoint connection as described above. Once the SharePoint connection is active, you should use the same methods for configuring the subscribers
Note: With the current MS Graph API capabilities, there is no way to grant granular permissions to specific lists. Site-level permissions need to be granted for JungleMail instead.
To authorize the SharePoint subscribers, navigate to JungleMail Settings > Subscriber Management and select SharePoint Subscribers.
Use the Add new list button to configure the subsccriber functionality.
If you are going with the Service Account option, ensure that the Service Account has Manage access to the Subscriber list.
If you are going with the Selected Sites mode, grant the JungleMail SharePoint Connection app "Write" permissions via the same PowerShell as described in the article above.
Grant-PnPAzureADAppSitePermission -AppId $appId -DisplayName "JM365 Data Manage" -Permissions Manage -Site $siteUrl