Hi ,
Welcome to the Support Portal. How can we help?

Upload your Workspace app in Teams

Table of Contents



You can integrate Workspace 365 as an application within Microsoft Teams. For this, the manifest.json ZIP file is required including the app icons. It can be found under the Downloads section and is only available to our partners

There are some known limitations in opening applications from the Workspace app in Teams. This includes opening applications with external links/shortcuts e.g. Power BI or Zendesk (due to security reasons), but also opening local applications. This is relevant to both mobile and desktop devices. You may receive an error message that your browser is blocking the application or none at all. We are currently looking into this. 



As an admin, make sure that the Workspace app is available in the Teams App Store for the users in your tenant. 

To enable Single Sign-On, we have added a few more steps to our previous instruction: adding the "webApplicationInfo" in the manifest.json file (step 1) and creating a scope defined by this API and authorizing the client application (step 2) in Azure AD.
If you already had your Workspace app published in Teams for the users in your tenant, you must execute the steps in step 2 and edit/replace the manifest.json file, reupload the zip file in the Microsoft Teams admin center and publish the app.


Step 1. Edit and zip the manifest.json file

  • Download and unzip the Workspace365-Teams-App ZIP file.
  • Change the ContentURL to your own URL:
"contentUrl": "https://workspace365instance.url/environmentname/Embed/Teams",
  • You can change the display name of the Workspace app in Teams, which is determined by the short name. In the example below, the display name in Teams will be "WS 365". Bare in mind when choosing a name containing too many characters, it won't be fully displayed in Teams.
"name": {
 "short": "WS 365"
   "full": Workspace 365"
  • Go to your Workspace SSO app registration in Azure AD.
  • On the overview page, copy and save the Application (client) ID.
  • Add the following code to add new properties to your Teams application manifest:
"webApplicationInfo": {
"id": "00000000-0000-0000-0000-000000000000",
"resource": "https://workspace365instance.url/environmentname"
  • Zip the manifest.json file including the app icons.

Back to top


Step 2. Under your Workspace SSO app registration in Azure AD, create a scope defined by this API and authorize the client application

  • Under Manage, select Expose an API.
  • Select Add a scope. In the panel that opens, enter access_as_user as the Scope name.
    • In the Who can consent? box, enter Admins and users.
    • Enter the details in the boxes for configuring the admin and user consent prompts with values that are appropriate for the access_as_user scope:
      • Admin consent display name: Teams can access the user’s profile.
      • Admin consent description: Teams can call the app’s web APIs as the current user.
      • User consent display name: Teams can access your profile and make requests on your behalf.
      • User consent description: Teams can call this app’s APIs with the same rights as you have.


    • Ensure that State is set to Enabled.
    • Select Add scope to save the details.
  • In the Authorized client applications section, identify the applications that you want to authorize for your app’s web application.
    • Select Add a client application.
    • Enter each of the following client IDs and select the authorized scope you created in the previous step:
      • 1fec8e78-bce4-4aaf-ab1b-5451cc387264 (for Teams mobile or desktop application).
      • 5e3ce6c0-2b1f-4285-8d4b-75ee78787346 (for Teams web application).

    • Select Add application.
    • For further detailed information about the SSO setup, click here.

Back to top

Step 3. Upload the zipfile in the Microsoft Teams admin center

  • Upload the created zipfile in the Microsoft Teams admin center:
    • Go to Teams apps and select Manage apps. 
    • Click on Upload to upload the ZIP file.
    • Click here for further detailed information.
  • Now the user can add the app themselves or you could create a policy to push the app to the users automatically.

Back to top


Setup policies

Once the app is uploaded in the Teams App Store, as an admin you can manage app setup policies. To create a policy, do the following:

  • Go to Teams apps.
  • Choose Setup policies.
  • Click on Add or change the current policy to add the Workspace 365 Teams app to the users left sidebar.

Automatically install the app for users

If you want to install the app for users automatically when they start Teams, follow these steps:

  • In the Add installed apps pane search for the app you want to automatically install. You can also filter apps by app permission policy.
  • Then, select Add.

    the Add installed apps pane

Back to top

Change app order in the Teams app navigation bar

It's also possible to arrange the apps in the order that you want them to appear in Teams.

  • Under Teams apps, select Setup policies.
  • Go to Pinned apps.
  • You can select an app and move it up- or downwards.
  • Then, select Save.


Back to top


Add the Workspace app as a user

When the app has been made available in the Teams App Store by the admin, the users can now add the Workspace app to Teams.

  • Click on Apps and search for the app. 


  • Click on Add to add it to Teams. 
  • The Workspace app is now added to Teams.


Back to top


App is blocked (white/black screen)

It could be the case that the Workspace app in Teams is being blocked by CSP. This results in a white (or black) screen. Self-hosted partners can resolve this issue by adding the following headers to the web.config:

<add name="Content-Security-Policy" value="script-src * 'unsafe-inline' 'unsafe-eval'; frame-ancestors 'self' *.workspace365.net teams.microsoft.com *.teams.microsoft.com *.skype.co https://teams.workspace365.net; " />

The web.config is located at: "C:\inetpub\wwwroot\*\Workspace 365\Web.config". 

Back to top