Swift
Swift
Microsoft Teams - Create Team (complex request)
See more Microsoft Teams Examples
Create a team with multiple channels, installed apps, and pinned tabs using delegated permissionsChilkat Swift Downloads
func chilkatTest() {
var success: Bool = false
// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
let http = CkoHttp()!
// 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
let json = CkoJsonObject()!
json.updateString(jsonPath: "\"template@odata.bind\"", value: "https://graph.microsoft.com/v1.0/teamsTemplates('standard')")
json.updateString(jsonPath: "visibility", value: "Private")
json.updateString(jsonPath: "displayName", value: "Sample Engineering Team")
json.updateString(jsonPath: "description", value: "This is a sample engineering team, used to showcase the range of properties supported by this API")
json.updateString(jsonPath: "channels[0].displayName", value: "Announcements")
json.updateBool(jsonPath: "channels[0].isFavoriteByDefault", value: true)
json.updateString(jsonPath: "channels[0].description", value: "This is a sample announcements channel that is favorited by default. Use this channel to make important team, product, and service announcements.")
json.updateString(jsonPath: "channels[1].displayName", value: "Training")
json.updateBool(jsonPath: "channels[1].isFavoriteByDefault", value: true)
json.updateString(jsonPath: "channels[1].description", value: "This is a sample training channel, that is favorited by default, and contains an example of pinned website and YouTube tabs.")
json.updateString(jsonPath: "channels[1].tabs[0].\"teamsApp@odata.bind\"", value: "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps('com.microsoft.teamspace.tab.web')")
json.updateString(jsonPath: "channels[1].tabs[0].name", value: "A Pinned Website")
json.updateString(jsonPath: "channels[1].tabs[0].configuration.contentUrl", value: "https://docs.microsoft.com/microsoftteams/microsoft-teams")
json.updateString(jsonPath: "channels[1].tabs[1].\"teamsApp@odata.bind\"", value: "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps('com.microsoft.teamspace.tab.youtube')")
json.updateString(jsonPath: "channels[1].tabs[1].name", value: "A Pinned YouTube Video")
json.updateString(jsonPath: "channels[1].tabs[1].configuration.contentUrl", value: "https://tabs.teams.microsoft.com/Youtube/Home/YoutubeTab?videoId=X8krAMdGvCQ")
json.updateString(jsonPath: "channels[1].tabs[1].configuration.websiteUrl", value: "https://www.youtube.com/watch?v=X8krAMdGvCQ")
json.updateString(jsonPath: "channels[2].displayName", value: "Planning")
json.updateString(jsonPath: "channels[2].description", value: "This is a sample of a channel that is not favorited by default, these channels will appear in the more channels overflow menu.")
json.updateBool(jsonPath: "channels[2].isFavoriteByDefault", value: false)
json.updateString(jsonPath: "channels[3].displayName", value: "Issues and Feedback")
json.updateString(jsonPath: "channels[3].description", value: "This is a sample of a channel that is not favorited by default, these channels will appear in the more channels overflow menu.")
json.updateBool(jsonPath: "memberSettings.allowCreateUpdateChannels", value: true)
json.updateBool(jsonPath: "memberSettings.allowDeleteChannels", value: true)
json.updateBool(jsonPath: "memberSettings.allowAddRemoveApps", value: true)
json.updateBool(jsonPath: "memberSettings.allowCreateUpdateRemoveTabs", value: true)
json.updateBool(jsonPath: "memberSettings.allowCreateUpdateRemoveConnectors", value: true)
json.updateBool(jsonPath: "guestSettings.allowCreateUpdateChannels", value: false)
json.updateBool(jsonPath: "guestSettings.allowDeleteChannels", value: false)
json.updateBool(jsonPath: "funSettings.allowGiphy", value: true)
json.updateString(jsonPath: "funSettings.giphyContentRating", value: "Moderate")
json.updateBool(jsonPath: "funSettings.allowStickersAndMemes", value: true)
json.updateBool(jsonPath: "funSettings.allowCustomMemes", value: true)
json.updateBool(jsonPath: "messagingSettings.allowUserEditMessages", value: true)
json.updateBool(jsonPath: "messagingSettings.allowUserDeleteMessages", value: true)
json.updateBool(jsonPath: "messagingSettings.allowOwnerDeleteMessages", value: true)
json.updateBool(jsonPath: "messagingSettings.allowTeamMentions", value: true)
json.updateBool(jsonPath: "messagingSettings.allowChannelMentions", value: true)
json.updateBool(jsonPath: "discoverySettings.showInTeamsSearchAndSuggestions", value: true)
json.updateString(jsonPath: "installedApps[0].\"teamsApp@odata.bind\"", value: "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps('com.microsoft.teamspace.tab.vsts')")
json.updateString(jsonPath: "installedApps[1].\"teamsApp@odata.bind\"", value: "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps('1542629c-01b3-4a6d-8f76-1938b779e48d')")
http.setRequestHeader(name: "Content-type", value: "application/json")
// Adds the "Authorization: Bearer ACCESS_TOKEN" header.
http.authToken = "ACCESS_TOKEN"
let resp = CkoHttpResponse()!
success = http.httpJson(verb: "POST", url: "https://graph.microsoft.com/v1.0/teams", json: json, contentType: "application/json", response: resp)
if success == false {
print("\(http.lastErrorText!)")
return
}
// A successful response is indicated by a 202 response status code and an empty response body.
print("Response Status Code: \(resp.statusCode.intValue)")
print("Response Body:")
print("\(resp.bodyStr!)")
if resp.statusCode.intValue >= 400 {
print("Response Header:")
print("\(resp.header!)")
print("Failed.")
}
}