{"title":"Create Business Central tabs for Teams","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-develop-for-teams-tabs/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-develop-for-teams-tabs, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-develop-for-teams-tabs","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Learn how to use the Graph API to programmatically add a Business Central tab in a Teams channel or chaT.","date":"2023-12-28","meta":{"topic":"how-to"},"outline":[{"level":1,"title":"Create Business Central tabs for Teams","slug":"create-business-central-tabs-for-teams","at":0,"chars":9165},{"level":2,"title":"Add tabs programmatically","slug":"add-tabs-programmatically","at":247,"chars":3783},{"level":3,"title":"For channels","slug":"for-channels","at":1262,"chars":587},{"level":3,"title":"For chats","slug":"for-chats","at":1849,"chars":548},{"level":3,"title":"Composing request body","slug":"composing-request-body","at":2397,"chars":1633},{"level":2,"title":"Example","slug":"example","at":4030,"chars":4882},{"level":3,"title":"Create team","slug":"create-team","at":4475,"chars":1086},{"level":3,"title":"Create channel","slug":"create-channel","at":5561,"chars":1086},{"level":3,"title":"Install the Business Central app for Teams","slug":"install-the-business-central-app-for-teams","at":6647,"chars":868},{"level":3,"title":"Add tab","slug":"add-tab","at":7515,"chars":1397},{"level":2,"title":"Next steps","slug":"next-steps","at":8912,"chars":162},{"level":2,"title":"Related information","slug":"related-information","at":9074,"chars":91}],"text":"# Create Business Central tabs for Teams\nThis article explains how to add tabs in Teams in channels and chats.\nTo learn about how users can add Business Central tabs in the Teams client, see Add a Business Central Tab in Teams</across-teams-tab>.\n## Add tabs programmatically\nMicrosoft Teams is part of the Microsoft REST Graph API<https://learn.microsoft.com/graph/overview>, which allows apps to connect to Teams and create resources like channels, chats, and tabs. Using the Graph API, you can add Business Central tabs to new or existing channels and chats in Teams. Together with the Business Central app for Teams, you can set up a Teams environment complete with teams, channels, and Business Central tabs&mdash;without requiring users to do anything extra.\nTo add a Business Central tab to a channel or chat, you send a POST request to either the channel tab<https://learn.microsoft.com/graph/api/channel-post-tabs> or chat tab<https://learn.microsoft.com/graph/api/chat-post-tabs?tabs=http> endpoint.\n> IMPORTANT\n> The user identity that runs the code must have access to the Business Central app for Teams for the POST request to succeed. To increase the reliability of your code, you can add the app to the Team channel or chat before adding the tab.\n### For channels\nYou need the ID the team and the channel that you want to add the tab to.\n```http\nPOST https://graph.microsoft.com/v1.0/teams/{teamId}/channels/{channelId}/tabs\n\n{\n    \"displayName\": \"<tab name>\",​\n    \"teamsApp@odata.bind\": ​\"https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/84c2de91-84e8-4bbf-b15d-9ef33245ad29\",​\n    \"configuration\": {​\n        \"entityId\": \"<unique id>\",​\n        \"contentUrl\": \"https://businesscentral.dynamics.com/teams?<company and page ID>\",​\n        \"websiteUrl\": \"https://businesscentral.dynamics.com/?<company and page ID>\"​\n    }\n}\n```\n### For chats\nYou need the ID the chat that you want to add the tab to.\n```http\nPOST https://graph.microsoft.com/v1.0/chats/{chat-id}/tabs\n\n{\n    \"displayName\": \"<tab name>\",​\n    \"teamsApp@odata.bind\": ​\"https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/84c2de91-84e8-4bbf-b15d-9ef33245ad29\",​\n    \"configuration\": {​\n        \"entityId\": \"<unique id>\",​\n        \"contentUrl\": \"https://businesscentral.dynamics.com/teams?<company and page ID>\",​\n        \"websiteUrl\": \"https://businesscentral.dynamics.com/?<company and page ID>\"​\n    }\n}\n```\n### Composing request body\nThe request body also called the payload, follows the request URL and specifies the content of the tab. There are several string properties that you can set. Some are required. The following table describes the properties and any specific values that you must provide.\nProperty|Description|Required\ndisplayName|Specifies the name that shows for the tab in the channel or chat|Yes\nteamsApp@odata.bind|This property binds the tab to the Business Central app for Teams. The ID of the Business Central app is 84c2de91-84e8-4bbf-b15d-9ef33245ad29. So set the value to `​\"https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/84c2de91-84e8-4bbf-b15d-9ef33245ad29\"`|Yes\nentityId|Specifies an identifier for tab\ncontentUrl|Specifies the URL used for rendering Business Central tab and its content in the channel or chat. It's important to include `/teams` in the path, which directs the Business Central web client to deliver a Teams-specific view and use the Teams authentication platform. If you omit it, that tab can't authenticate. Replace `<company and page ID>` with parameters that identify the company and page that you want to show. For more information about the Business Central web client URL and parameters, see Web Client URL<devenv-web-client-urls>.|Yes\nremoveUrl|Specifies the URL called by Teams client when a tab is removed using the Teams client.\nwebsiteUrl|Specifies the URL for showing tab contents outside of Teams, which users do by selecting Go to website option on the tab in the Teams client. Typically, you would set the value to the URL of the Business Central page in the web client.\n## Example\nThis example illustrates how you can add a team, channel, and Business Central tab. You add a tab in Teams that displays page 9305 Sale Orders. There are several tools that you can use, like AL code, PowerShell, API explorer tools, and more. In this example, you use the Graph Explorer. For details about using Graph Explorer, see Working with Graph Explorer<https://learn.microsoft.com/graph/graph-explorer/graph-explorer-features>.\n### Create team\n1. Open and sign in to https://developer.microsoft.com/graph/graph-explorer.\n2. Create a team.\n The first step is to create a team using the https://learn.microsoft.com/graph/api/team-post?tabs=http endpoint. In this example, you create a team named is Warehouse.\n 1. At the top, set the method to Post and add the following URL:\n  ```http\n  https://graph.microsoft.com/v1.0/teams\n  ```\n 2. Go to the Modify permissions tab and consent to required permissions.\n 3. In the Request body, add the following:\n  ```json\n  {\n    \"template@odata.bind\": \"https://graph.microsoft.com/v1.0/teamsTemplates('standard')\",\n    \"displayName\": \"Warehouse\",\n    \"description\": \"Team for communicating with the warehouse personnel\"\n  }\n  ```\n 4. Select Run Query.\n  If successful, you get an Accepted - 202 message.\n 5. In the Response headers, get the ID of the new team from the `\"location\"` entry:\n  ```http\n  \"location\": \"/teams('734c3798-b644-4b50-8f42-b3d56b6d1e35')/operations('df79c928-7cae-4d3f-8584-016d01dcfc56')\",\n  ```\n  In this case, `734c3798-b644-4b50-8f42-b3d56b6d1e35`.\n### Create channel\nThe next step is to create a channel using the https://learn.microsoft.com/graph/api/channel-post?tabs=http endpoint. In this example, you create a channel for raising issues about sales orders.\n1. Start a new query, set the method to Post and add the following endpoint URL:\n ```http\n https://graph.microsoft.com/v1.0/teams/734c3798-b644-4b50-8f42-b3d56b6d1e35/channels\n ```\n2. Go to the Modify permissions tab and consent to required permissions.\n3. In the Request body, add the following:\n ```json\n {\n   \"displayName\": \"Sales order complaints\",\n   \"description\": \"This channel is for raising issues with sales orders. \",\n   \"membershipType\": \"standard\"\n }\n ```\n4. Select Run Query.\n If successful, you get an Created - 201 message.\n5. In the Response headers, get the ID of the new team from the `\"location\"` entry:\n ```http\n \"location\": \"https://teamsgraph.teams.microsoft.com/v1.0/teams('734c3798-b644-4b50-8f42-b3d56b6d1e35')/channels('19:7f4bae394f7c479a921c679123aa8e7c@thread.tacv2')\",\n ```\n In this case, `19:7f4bae394f7c479a921c679123aa8e7c@thread.tacv2`.\n### Install the Business Central app for Teams\nComplete this step if the Business Central app isn't already installed for the team. The app must be installed in the team, otherwise you get an error when you try to add the tab.\n1. Start a new query, set the method to Post and add the following endpoint URL:\n ```http\n https://graph.microsoft.com/v1.0/teams/734c3798-b644-4b50-8f42-b3d56b6d1e35/installedApps\n ```\n For more information about this endpoint, go to Post app in team<https://learn.microsoft.com/graph/api/team-post-installedapps>.\n2. Go to the Modify permissions tab and consent to required permissions.\n3. In the Request body, add the following:\n ```json\n {\n \"teamsApp@odata.bind\": \"https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/84c2de91-84e8-4bbf-b15d-9ef33245ad29\"\n }\n ```\n4. Select Run Query.\n If successful, you get an Created - 201 message.\n### Add tab\nThe final step is to add a Business Central tab to the channel by using the https://learn.microsoft.com/graph/api/channel-post-tabs endpoint.\n1. Start a new query, set the method to Post and add the following endpoint URL:\n ```http\n https://graph.microsoft.com/v1.0/teams/734c3798-b644-4b50-8f42-b3d56b6d1e35/channels/19:7f4bae394f7c479a921c679123aa8e7c@thread.tacv2/tabs\n ```\n2. Go to the Modify permissions tab and consent to required permissions.\n3. In the Request body, add the following:\n ```json\n {\n     \"displayName\": \"Overdue Sales Orders\",\n     \"teamsApp@odata.bind\": \"https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/84c2de91-84e8-4bbf-b15d-9ef33245ad29\",\n     \"configuration\": {\n         \"entityId\": \"2DCA2E6C7A10415CAF6B8AB6661B3154\",\n         \"contentUrl\": \"https://businesscentral.dynamics.com/teams?company=CRONUS%20USA%2C%20Inc.&page=9305\",\n         \"websiteUrl\": \"https://businesscentral.dynamics.com/?company=CRONUS%20USA%2C%20Inc.&page=9305\"\n     }\n }\n ```\n4. Select Run Query.\n If successful, you get an Created - 201 message.\n5. In the Response headers, get the ID of the new team from the `\"location\"` entry:\n ```http\n \"location\": \"https://teamsgraph.teams.microsoft.com/v1.0/teams('734c3798-b644-4b50-8f42-b3d56b6d1e35')/channels('19:7f4bae394f7c479a921c679123aa8e7c@thread.tacv2')\",\n ```\n In this case, `19:7f4bae394f7c479a921c679123aa8e7c@thread.tacv2`.\n## Next steps\nChange the recommended content for the tab. See Add and Remove Recommended Content for Business Central Tabs<devenv-develop-for-teams-tab-content>.\n## Related information\nDeveloping for Microsoft Teams Integration<devenv-develop-for-teams>"}