Sample code for 30+ languages & platforms
Xbase++

Microsoft Teams - Create Team (complex request)

See more Microsoft Teams Examples

Create a team with multiple channels, installed apps, and pinned tabs using delegated permissions

Chilkat Xbase++ Downloads

Xbase++
LOCAL nSuccess
LOCAL oHttp
LOCAL oJson
LOCAL oResp

nSuccess := 0

//  This example assumes the Chilkat API to have been previously unlocked.
//  See Global Unlock Sample for sample code.

oHttp := CreateObject("Chilkat.Http")

//  Build the following HTTP request:

//  POST https://graph.microsoft.com/v1.0/teams
//  Content-Type: application/json
//  
//  {
//      "template@odata.bind": "https://graph.microsoft.com/v1.0/teamsTemplates('standard')",
//      "visibility": "Private",
//      "displayName": "Sample Engineering Team",
//      "description": "This is a sample engineering team, used to showcase the range of properties supported by this API",
//      "channels": [
//          {
//              "displayName": "Announcements",
//              "isFavoriteByDefault": true,
//              "description": "This is a sample announcements channel that is favorited by default. Use this channel to make important team, product, and service announcements."
//          },
//          {
//              "displayName": "Training",
//              "isFavoriteByDefault": true,
//              "description": "This is a sample training channel, that is favorited by default, and contains an example of pinned website and YouTube tabs.",
//              "tabs": [
//                  {
//                      "teamsApp@odata.bind": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps('com.microsoft.teamspace.tab.web')",
//                      "name": "A Pinned Website",
//                      "configuration": {
//                          "contentUrl": "https://docs.microsoft.com/microsoftteams/microsoft-teams"
//                      }
//                  },
//                  {
//                      "teamsApp@odata.bind": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps('com.microsoft.teamspace.tab.youtube')",
//                      "name": "A Pinned YouTube Video",
//                      "configuration": {
//                          "contentUrl": "https://tabs.teams.microsoft.com/Youtube/Home/YoutubeTab?videoId=X8krAMdGvCQ",
//                          "websiteUrl": "https://www.youtube.com/watch?v=X8krAMdGvCQ"
//                      }
//                  }
//              ]
//          },
//          {
//              "displayName": "Planning",
//              "description": "This is a sample of a channel that is not favorited by default, these channels will appear in the more channels overflow menu.",
//              "isFavoriteByDefault": false
//          },
//          {
//              "displayName": "Issues and Feedback",
//              "description": "This is a sample of a channel that is not favorited by default, these channels will appear in the more channels overflow menu."
//          }
//      ],
//      "memberSettings": {
//          "allowCreateUpdateChannels": true,
//          "allowDeleteChannels": true,
//          "allowAddRemoveApps": true,
//          "allowCreateUpdateRemoveTabs": true,
//          "allowCreateUpdateRemoveConnectors": true
//      },
//      "guestSettings": {
//          "allowCreateUpdateChannels": false,
//          "allowDeleteChannels": false
//      },
//      "funSettings": {
//          "allowGiphy": true,
//          "giphyContentRating": "Moderate",
//          "allowStickersAndMemes": true,
//          "allowCustomMemes": true
//      },
//      "messagingSettings": {
//          "allowUserEditMessages": true,
//          "allowUserDeleteMessages": true,
//          "allowOwnerDeleteMessages": true,
//          "allowTeamMentions": true,
//          "allowChannelMentions": true
//      },
//      "discoverySettings": {
//          "showInTeamsSearchAndSuggestions": true
//      },
//      "installedApps": [
//          {
//              "teamsApp@odata.bind": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps('com.microsoft.teamspace.tab.vsts')"
//          },
//          {
//              "teamsApp@odata.bind": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps('1542629c-01b3-4a6d-8f76-1938b779e48d')"
//          }
//      ]
//  }

//  Use this online tool to generate code from sample JSON:
//  Generate Code to Create JSON

oJson := CreateObject("Chilkat.JsonObject")
oJson:UpdateString('"template@odata.bind"', "https://graph.microsoft.com/v1.0/teamsTemplates('standard')")
oJson:UpdateString("visibility", "Private")
oJson:UpdateString("displayName", "Sample Engineering Team")
oJson:UpdateString("description", "This is a sample engineering team, used to showcase the range of properties supported by this API")
oJson:UpdateString("channels[0].displayName", "Announcements")
oJson:UpdateBool("channels[0].isFavoriteByDefault", 1)
oJson:UpdateString("channels[0].description", "This is a sample announcements channel that is favorited by default. Use this channel to make important team, product, and service announcements.")
oJson:UpdateString("channels[1].displayName", "Training")
oJson:UpdateBool("channels[1].isFavoriteByDefault", 1)
oJson:UpdateString("channels[1].description", "This is a sample training channel, that is favorited by default, and contains an example of pinned website and YouTube tabs.")
oJson:UpdateString('channels[1].tabs[0]."teamsApp@odata.bind"', "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps('com.microsoft.teamspace.tab.web')")
oJson:UpdateString("channels[1].tabs[0].name", "A Pinned Website")
oJson:UpdateString("channels[1].tabs[0].configuration.contentUrl", "https://docs.microsoft.com/microsoftteams/microsoft-teams")
oJson:UpdateString('channels[1].tabs[1]."teamsApp@odata.bind"', "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps('com.microsoft.teamspace.tab.youtube')")
oJson:UpdateString("channels[1].tabs[1].name", "A Pinned YouTube Video")
oJson:UpdateString("channels[1].tabs[1].configuration.contentUrl", "https://tabs.teams.microsoft.com/Youtube/Home/YoutubeTab?videoId=X8krAMdGvCQ")
oJson:UpdateString("channels[1].tabs[1].configuration.websiteUrl", "https://www.youtube.com/watch?v=X8krAMdGvCQ")
oJson:UpdateString("channels[2].displayName", "Planning")
oJson:UpdateString("channels[2].description", "This is a sample of a channel that is not favorited by default, these channels will appear in the more channels overflow menu.")
oJson:UpdateBool("channels[2].isFavoriteByDefault", 0)
oJson:UpdateString("channels[3].displayName", "Issues and Feedback")
oJson:UpdateString("channels[3].description", "This is a sample of a channel that is not favorited by default, these channels will appear in the more channels overflow menu.")
oJson:UpdateBool("memberSettings.allowCreateUpdateChannels", 1)
oJson:UpdateBool("memberSettings.allowDeleteChannels", 1)
oJson:UpdateBool("memberSettings.allowAddRemoveApps", 1)
oJson:UpdateBool("memberSettings.allowCreateUpdateRemoveTabs", 1)
oJson:UpdateBool("memberSettings.allowCreateUpdateRemoveConnectors", 1)
oJson:UpdateBool("guestSettings.allowCreateUpdateChannels", 0)
oJson:UpdateBool("guestSettings.allowDeleteChannels", 0)
oJson:UpdateBool("funSettings.allowGiphy", 1)
oJson:UpdateString("funSettings.giphyContentRating", "Moderate")
oJson:UpdateBool("funSettings.allowStickersAndMemes", 1)
oJson:UpdateBool("funSettings.allowCustomMemes", 1)
oJson:UpdateBool("messagingSettings.allowUserEditMessages", 1)
oJson:UpdateBool("messagingSettings.allowUserDeleteMessages", 1)
oJson:UpdateBool("messagingSettings.allowOwnerDeleteMessages", 1)
oJson:UpdateBool("messagingSettings.allowTeamMentions", 1)
oJson:UpdateBool("messagingSettings.allowChannelMentions", 1)
oJson:UpdateBool("discoverySettings.showInTeamsSearchAndSuggestions", 1)
oJson:UpdateString('installedApps[0]."teamsApp@odata.bind"', "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps('com.microsoft.teamspace.tab.vsts')")
oJson:UpdateString('installedApps[1]."teamsApp@odata.bind"', "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps('1542629c-01b3-4a6d-8f76-1938b779e48d')")

oHttp:SetRequestHeader("Content-type", "application/json")

//  Adds the "Authorization: Bearer ACCESS_TOKEN" header.
oHttp:AuthToken := "ACCESS_TOKEN"

oResp := CreateObject("Chilkat.HttpResponse")
nSuccess := oHttp:HttpJson("POST", "https://graph.microsoft.com/v1.0/teams", oJson, "application/json", oResp)
IF (nSuccess == 0)
    ? oHttp:LastErrorText
    oHttp:destroy()
    oJson:destroy()
    oResp:destroy()
    RETURN
ENDIF

//  A successful response is indicated by a 202 response status code and an empty response body.
? "Response Status Code: " + Str(oResp:StatusCode)
? "Response Body:"
? oResp:BodyStr

IF (oResp:StatusCode >= 400)
    ? "Response Header:"
    ? oResp:Header
    ? "Failed."
ENDIF

oHttp:destroy()
oJson:destroy()
oResp:destroy()