Skip to main content

Get Team

Retrieves detailed information about a specific Microsoft Teams team by its ID.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If ContinueOnError property is true, no error is caught when the project is executed even if Catch node is used.

Input​

  • Client Id - The client ID from the Connect node. Optional if using direct credentials.
  • Team Id - The unique identifier of the team to retrieve (required).

Output​

  • Team - Team object containing:
    • Id - Unique identifier
    • DisplayName - Team name
    • Description - Team description
    • IsArchived - Whether team is archived
    • WebUrl - Link to team in Teams app
    • Additional team metadata and settings

Options​

  • Credentials - OAuth2 credentials JSON (optional if using Client ID). Allows direct authentication without Connect node.

Examples​

Get Team Details​

Retrieve information about a specific team:

team_id = "19:abc123def456..."

// Get Team node
// Output: team object

// Access team properties
console.log("Team: " + team.DisplayName)
console.log("Description: " + team.Description)
console.log("Archived: " + team.IsArchived)
console.log("URL: " + team.WebUrl)

Verify Team Before Operations​

Check team details before performing actions:

team_id = "19:abc123def456..."

// Get Team node
team = message.team

// Verify team is active
if (team.IsArchived) {
    throw new Error("Cannot operate on archived team")
}

// Proceed with operations
// CreateChannel, SendMessage, etc.

Get Team from List​

Find and get specific team details:

// ListTeams node
teams = message.team.value

// Find specific team by name
project_team = teams.find(t =>
    t.DisplayName === "Project Alpha"
)

// Get full details
team_id = project_team.Id
// Get Team node
team = message.team

// Now you have complete team information

Tips for Effective Use​

  • Cache team data: Store team information to avoid repeated API calls
  • Check archived: Verify team is not archived before operations
  • Use for validation: Confirm team exists before creating channels
  • Get metadata: Access team settings and configuration
  • Error handling: Handle cases where team doesn't exist

Common Errors and Solutions​

"Team Id cannot be empty"​

Cause: No team ID provided.

Solution:

// Get team ID from ListTeams first
// ListTeams node
teams = message.team.value
team_id = teams[0].Id

// Then use in Get Team

Team Not Found​

Cause: Team ID doesn't exist or user doesn't have access.

Solution:

  • Verify team ID is correct
  • Check user has access to the team
  • Use ListTeams to find valid team IDs