Step 1. Edit and zip the manifest.json file

Table of Contents



To add the Workspace 365 app to Teams, the first step is to configure the manifest.json file according to your workspace setup. In this article, we explain how.



Download the 'Workspace365-Teams-App' ZIP file

  1. Download the ZIP file from our downloads page.


Edit the manifest file

Note: when following the instructions below, bear in mind that the entered Workspace URL must contain a domain which is available in the customer's Azure tenant. This could be a subdomain or a custom URL

  1. Unzip the downloaded file.
  2. Right-click the manifest file and open it with Notepad or Notepad++.
  3. Change the ContentURL. Adjust the red text to your own Workspace environment URL.
    "contentUrl": "https://workspace365instance.url/environmentname/Embed/Teams",
  4. You can determine the display name of the Workspace app in Teams by changing the short name to your liking.
    Bear in mind that when choosing a name containing too many characters, it won’t be fully displayed in Teams.
    In the example below, the display name in Teams will be “WS 365”.
    "name": {
    "short": "WS 365"
    "full": "Workspace 365"
  5. In Microsoft Entra ID (previously called Azure AD), go to your Workspace SSO app registration.
  6. Go to the Overview page.
  7. Note down the Application (client) ID.
  8. Select Expose an API.
  9. Click the pencil icon (or click 'Set') to adjust the Application ID URI.
  10. The Application ID URI should have the following format, replace instance with your own instance URL without the HTTPS (e.g.
  11. Click Save.
  12. In the manifest.json file, adjust the webApplicationInfo. For both values, keep the quotation marks.
    • “id”: replace this with the Application (client) ID you got from step 7.
    • “resource”: replace this with the same format as the Application ID URI.
      "webApplicationInfo": {
      "id": "00000000-0000-0000-0000-000000000000",
      "resource": "api://instance/00000000-0000-0000-0000-000000000000"
  13. Save the changes you made to the manifest.json file.
  14. Select the manifest.json, Icon-Medium.png and Icon-Small.png files and add them to a ZIP-file.
It must be a .zip file.


Back to top

Proceed to step 2