Dart
Dart
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 Dart Downloads
import 'package:chilkat/chilkat.dart';
void main() {
// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
final http = 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
final json = CkJsonObject();
json.updateString('"template@odata.bind"', 'https://graph.microsoft.com/v1.0/teamsTemplates(\'standard\')');
json.updateString('visibility', 'Private');
json.updateString('displayName', 'Sample Engineering Team');
json.updateString('description', 'This is a sample engineering team, used to showcase the range of properties supported by this API');
json.updateString('channels[0].displayName', 'Announcements');
json.updateBool('channels[0].isFavoriteByDefault', true);
json.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.');
json.updateString('channels[1].displayName', 'Training');
json.updateBool('channels[1].isFavoriteByDefault', true);
json.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.');
json.updateString('channels[1].tabs[0]."teamsApp@odata.bind"', 'https://graph.microsoft.com/v1.0/appCatalogs/teamsApps(\'com.microsoft.teamspace.tab.web\')');
json.updateString('channels[1].tabs[0].name', 'A Pinned Website');
json.updateString('channels[1].tabs[0].configuration.contentUrl', 'https://docs.microsoft.com/microsoftteams/microsoft-teams');
json.updateString('channels[1].tabs[1]."teamsApp@odata.bind"', 'https://graph.microsoft.com/v1.0/appCatalogs/teamsApps(\'com.microsoft.teamspace.tab.youtube\')');
json.updateString('channels[1].tabs[1].name', 'A Pinned YouTube Video');
json.updateString('channels[1].tabs[1].configuration.contentUrl', 'https://tabs.teams.microsoft.com/Youtube/Home/YoutubeTab?videoId=X8krAMdGvCQ');
json.updateString('channels[1].tabs[1].configuration.websiteUrl', 'https://www.youtube.com/watch?v=X8krAMdGvCQ');
json.updateString('channels[2].displayName', 'Planning');
json.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.');
json.updateBool('channels[2].isFavoriteByDefault', false);
json.updateString('channels[3].displayName', 'Issues and Feedback');
json.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.');
json.updateBool('memberSettings.allowCreateUpdateChannels', true);
json.updateBool('memberSettings.allowDeleteChannels', true);
json.updateBool('memberSettings.allowAddRemoveApps', true);
json.updateBool('memberSettings.allowCreateUpdateRemoveTabs', true);
json.updateBool('memberSettings.allowCreateUpdateRemoveConnectors', true);
json.updateBool('guestSettings.allowCreateUpdateChannels', false);
json.updateBool('guestSettings.allowDeleteChannels', false);
json.updateBool('funSettings.allowGiphy', true);
json.updateString('funSettings.giphyContentRating', 'Moderate');
json.updateBool('funSettings.allowStickersAndMemes', true);
json.updateBool('funSettings.allowCustomMemes', true);
json.updateBool('messagingSettings.allowUserEditMessages', true);
json.updateBool('messagingSettings.allowUserDeleteMessages', true);
json.updateBool('messagingSettings.allowOwnerDeleteMessages', true);
json.updateBool('messagingSettings.allowTeamMentions', true);
json.updateBool('messagingSettings.allowChannelMentions', true);
json.updateBool('discoverySettings.showInTeamsSearchAndSuggestions', true);
json.updateString('installedApps[0]."teamsApp@odata.bind"', 'https://graph.microsoft.com/v1.0/appCatalogs/teamsApps(\'com.microsoft.teamspace.tab.vsts\')');
json.updateString('installedApps[1]."teamsApp@odata.bind"', 'https://graph.microsoft.com/v1.0/appCatalogs/teamsApps(\'1542629c-01b3-4a6d-8f76-1938b779e48d\')');
http.setRequestHeader('Content-type', 'application/json');
// Adds the "Authorization: Bearer ACCESS_TOKEN" header.
http.authToken = 'ACCESS_TOKEN';
final resp = CkHttpResponse();
try {
http.httpJson('POST', 'https://graph.microsoft.com/v1.0/teams', json, 'application/json', resp);
} on ChilkatException catch (e) {
print(e.lastErrorText);
return;
}
// A successful response is indicated by a 202 response status code and an empty response body.
print('Response Status Code: ${resp.statusCode}');
print('Response Body:');
print(resp.bodyStr);
if (resp.statusCode >= 400) {
print('Response Header:');
print(resp.header);
print('Failed.');
}
}