#1 Global Leader in Data Resilience

How to Activate Access to Microsoft Graph Teams Export APIs

KB ID: 4322
Product: Veeam Backup for Microsoft 365 | 7.0 | 7a | 8
Published: 2022-06-11
Last Modified: 2024-09-05
mailbox
Get weekly article updates
By subscribing, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.

Cheers for trusting us with the spot in your mailbox!

Now you’re less likely to miss what’s been brewing in our knowledge base with this weekly digest

error icon

Oops! Something went wrong.

Please, try again later.

Preliminary Action

This article documents how to link your Azure subscription to your app registration for billing to access Microsoft Graph Export API for Teams. This is needed to enable Veeam Backup for Microsoft 365 6a and newer to utilize that API to protect Teams public channel posts.

After the Teams Protected APIs are accessed and Veeam Backup for Microsoft 365 6a or later is installed, follow the steps in KB4340 to enable the use of those APIs.

Purpose

Veeam Backup for Microsoft 365 6a and later provides an option to leverage Microsoft Graph Export API for Teams to back up Teams public channel posts.

Support for Microsoft Graph Export API for Teams was implemented in Veeam Backup for Microsoft 365 6a and later because Microsoft deprecated the ability for EWS APIs to access the TeamsMessagesData folder.

By default, Veeam Backup for Microsoft 365 7.0 and previous versions will attempt to utilize EWS APIs to protect the TeamsMessagsesData folder. However, as Microsoft has now deprecated EWS API access to the TeamsMessagesData folder, the only way to backup Teams public channel posts will be to configure Veeam Backup for Microsoft 365 to utilize the Teams Export APIs.

Important Notes:

  • Additional steps must be performed to protect Teams public channel posts, and then the Teams backup must be explicitly enabled.
  • Utilizing the Microsoft Graph Export API for Teams comes at an additional cost from Microsoft.Veeam Backup for Microsoft 365 6a's API request will be considered as "model=B"
  • The Microsoft Graph Export API for Teams is currently not supported in Microsoft 365 US Government region or China region.

 

Solution

Step 1: Register App

When adding an organization with modern authentication to Veeam Backup for Microsoft 365, after following the login prompts, you will end up with an app registration. You will need information about this app registration to request Protected API access in the next section.

  1. Log into portal.azure.com and select Microsoft Entra ID.
    If your account has access to more than one directory, ensure you have selected the relevant one.
  2. Within the Basic information section, gather the Tenant ID.
  3. In the Veeam Backup for Microsoft 365 Console, right-click the Organization and select 'Edit organization'. Gather the Application ID.
  4. Under App Registrations in Azure AD, review the API permissions assigned to the app registration used.
    Ensure that the Microsoft Graph Application permission to ChannelMessage.Read.All is assigned.

Step 2: Associate Subscription with App Registration for Billing

Ensure that your subscription is associated with the app registration for billing purposes.

If the app registration is not linked with a valid billable subscription, Microsoft Teams Export API access will fail with the following error:

Failed to process team: <Team Name>. To call this API, the app must be associated with an Azure subscription, see https://aka.ms/teams-api-payment-requirements for details.. The remote server returned an error: (402) Payment Required
To submit feedback regarding this article, please click this link: Send Article Feedback
To report a typo on this page, highlight the typo with your mouse and press CTRL + Enter.

Spelling error in text

This site is protected by hCaptcha and its Privacy Policy and Terms of Service apply except as noted in our Privacy Policy.
Thank you!

Thank you!

Your feedback has been received and will be reviewed.

Oops! Something went wrong.

Please, try again later.

You have selected too large block!

Please try select less.

KB Feedback/Suggestion

This form is only for KB Feedback/Suggestions, if you need help with the software open a support case

By submitting, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.
This site is protected by hCaptcha and its Privacy Policy and Terms of Service apply except as noted in our Privacy Policy.
Verify your email to continue your product download
We've sent a verification code to:
  • Incorrect verification code. Please try again.
An email with a verification code was just sent to
Didn't receive the code? Click to resend in sec
Didn't receive the code? Click to resend
Thank you!

Thank you!

Your feedback has been received and will be reviewed.

error icon

Oops! Something went wrong.

Please, try again later.