https://github.com/tools4everbv/helloid-conn-sa-full-teams-removeteam
Microsoft Teams - Team remove
https://github.com/tools4everbv/helloid-conn-sa-full-teams-removeteam
delegated-form import microsoft-teams powershell service-automation
Last synced: 21 days ago
JSON representation
Microsoft Teams - Team remove
- Host: GitHub
- URL: https://github.com/tools4everbv/helloid-conn-sa-full-teams-removeteam
- Owner: Tools4everBV
- Created: 2020-12-05T12:06:41.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2026-04-01T09:25:23.000Z (3 months ago)
- Last Synced: 2026-04-01T11:28:30.881Z (3 months ago)
- Topics: delegated-form, import, microsoft-teams, powershell, service-automation
- Language: PowerShell
- Homepage:
- Size: 39.1 KB
- Stars: 0
- Watchers: 4
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# HelloID-Conn-SA-Full-Teams-RemoveTeam
| :information_source: Information |
|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| This repository contains the connector and configuration code only. The implementer is responsible for acquiring the connection details such as username, password, certificate, etc. You might even need to sign a contract or agreement with the supplier before implementing this connector. Please contact the client's application manager to coordinate the connector requirements. |
## Description
_HelloID-Conn-SA-Full-Teams-RemoveTeam_ is a template designed for use with HelloID Service Automation (SA) Delegated Forms. It can be imported into HelloID and customized according to your requirements.
By using this delegated form , you can remove Microsoft Teams teams through Microsoft Graph. The delegated form supports the following flow:
1. Search for an existing Microsoft Team by display name or mail nickname
2. Select the team to remove
3. Delete the selected team (this deletes the underlying Microsoft 365 group)
## Getting started
### Requirements
- **Microsoft Entra application registration (certificate-based)**:
The connector authenticates to Microsoft Graph using a certificate (client credentials flow).
- **Microsoft Graph application permissions**:
Configure and grant admin consent for the following minimal application permission:
- `Group.ReadWrite.All`
### Connection settings
The following user-defined variables are used by the connector.
| Setting | Description | Mandatory |
|--------------------------------|----------------------------------------------------------------------------|-----------|
| EntraIdTenantId | Microsoft Entra tenant ID | Yes |
| EntraIdAppId | Application (client) ID of the app registration | Yes |
| EntraIdCertificateBase64String | Base64 encoded certificate (including private key) used for authentication | Yes |
| EntraIdCertificatePassword | Password for the certificate | Yes |
## Remarks
### Microsoft Graph Query Behavior
- `ConsistencyLevel: eventual` is added on Graph requests where advanced query capabilities are used (for example filtering and searching result sets). This allows Microsoft Graph to evaluate those queries correctly and consistently, especially when data has just changed.
### Deletion Scope
- Removing a team deletes the Microsoft 365 group behind that team. Content and resources linked to that group are removed according to Microsoft 365 behavior.
## Development resources
### API endpoints
The following endpoints are used by the connector.
| Endpoint | Description |
|-------------------------------------------------------------|-------------------------------------------------------------------------|
| `https://login.microsoftonline.com/{tenantId}/oauth2/token` | Retrieve OAuth2 access token using certificate-based client credentials |
| `https://graph.microsoft.com/v1.0/groups` | Search Teams-enabled groups and delete the selected group |
### API documentation
- https://learn.microsoft.com/graph/api/overview
- https://learn.microsoft.com/graph/api/group-list
- https://learn.microsoft.com/graph/api/group-delete
## Getting help
> :bulb: **Tip:**
> _For more information on Delegated Forms, please refer to our [documentation](https://docs.helloid.com/en/service-automation/delegated-forms.html) pages_.
## HelloID docs
The official HelloID documentation can be found at: https://docs.helloid.com/