Actions38
- User Actions
- Department Actions
- User Group Actions
- User Group Member Actions
- Unit Actions
- Workforce Type Actions
- Custom User Field Actions
- Contact Scope Actions
Overview
This node manages user groups within the Lark Contacts system, specifically allowing deletion of a user group. It is useful in scenarios where an organization needs to programmatically remove obsolete or unwanted user groups from their Lark workspace. For example, automating cleanup of user groups after project completion or restructuring teams.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating API requests; options are "Tenant Token" or "OAuth2". |
| Group Id | The unique identifier of the user group that you want to delete. |
| Options | Additional optional settings; currently supports "Use Custom Body" to send a custom request body. |
Output
The node outputs JSON data representing the response from the Lark API after attempting to delete the specified user group. This typically includes success status and any relevant messages or error details returned by the API. There is no binary output.
Dependencies
- Requires valid authentication credentials for Lark API access, either via a tenant token or OAuth2.
- Needs network connectivity to
https://open.larksuite.com/open-apis. - Proper configuration of authentication credentials in n8n is necessary.
Troubleshooting
Common issues:
- Invalid or expired authentication tokens will cause authorization errors.
- Providing a non-existent or incorrect Group Id will result in a not found or similar error.
- Network issues may prevent communication with the Lark API endpoint.
Error messages:
- Authorization errors indicate problems with the provided API credentials; verify and refresh tokens as needed.
- "Group not found" or similar errors mean the Group Id does not exist or is mistyped.
- Timeout or connection errors suggest network problems or API service downtime.