CIPP icon

CIPP

Interact with CIPP API

Actions129

Overview

This node operation allows users to add a new Team within Microsoft Teams via the CIPP API. It is useful for automating the creation of Teams with specific configurations such as display name, description, owner, and visibility settings. For example, an organization can automate team creation for new projects or departments, ensuring consistent team setup and ownership assignment.

Use Case Examples

  1. Create a new private Team named 'Project Alpha' with a specified owner and description.
  2. Add a public Team for a department with a given tenant filter to manage access and collaboration.

Properties

Name Meaning
Tenant Filter The tenant ID or domain name to specify the tenant context for the Team creation.
Display Name The display name of the Team to be created.
Description Optional description of the Team.
Owner User principal name of the Team owner, required to assign ownership.
Visibility Visibility setting of the Team, either Public or Private.
Request Options Advanced request settings including batching, SSL certificate validation, proxy configuration, and request timeout.

Output

JSON

  • id - The unique identifier of the newly created Team.
  • displayName - The display name of the created Team.
  • description - The description of the created Team.
  • owner - The user principal name of the Team owner.
  • visibility - The visibility status of the Team (public or private).
  • createdDateTime - Timestamp when the Team was created.

Dependencies

  • Requires an API key credential for authentication with the CIPP API, specifically configured for Microsoft Teams & SharePoint operations.

Troubleshooting

  • Ensure the tenantFilter is correctly specified as the tenant ID or domain name; incorrect values may cause authorization errors.
  • Verify the owner user principal name is valid and has permissions to own a Team; invalid owners will cause the operation to fail.
  • Check network settings if using a proxy or if SSL issues occur; misconfiguration can lead to request failures.
  • Timeout errors may occur if the server is slow to respond; adjust the timeout setting accordingly.

Links

Discussion