Tcl
Microsoft Teams - Create Team (complex request)

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

Tcl

load ./chilkat.dll

set success 0

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

set http [new_CkHttp]

# 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

set json [new_CkJsonObject]

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

CkHttp_SetRequestHeader $http "Content-type" "application/json"

# Adds the "Authorization: Bearer ACCESS_TOKEN" header.
CkHttp_put_AuthToken $http "ACCESS_TOKEN"

set resp [new_CkHttpResponse]

set success [CkHttp_HttpJson $http "POST" "https://graph.microsoft.com/v1.0/teams" $json "application/json" $resp]
if {$success == 0} then {
    puts [CkHttp_lastErrorText $http]
    delete_CkHttp $http
    delete_CkJsonObject $json
    delete_CkHttpResponse $resp
    exit
}

# A successful response is indicated by a 202 response status code and an empty response body.
puts "Response Status Code: [CkHttpResponse_get_StatusCode $resp]"
puts "Response Body:"
puts [CkHttpResponse_bodyStr $resp]

if {[CkHttpResponse_get_StatusCode $resp] >= 400} then {
    puts "Response Header:"
    puts [CkHttpResponse_header $resp]
    puts "Failed."
}


delete_CkHttp $http
delete_CkJsonObject $json
delete_CkHttpResponse $resp