Lark Calendar icon

Lark Calendar

Lark Calendar Management

Actions32

Overview

This node integrates with the Lark Calendar API to manage calendar events. Specifically, the "Delete An Event" operation allows users to remove a specified event from a given calendar. This is useful in scenarios where automated workflows need to clean up outdated or canceled events, maintain calendar accuracy, or synchronize event deletions across systems.

For example, an organization might use this node to automatically delete meetings that were canceled in another system, ensuring their Lark Calendar stays up-to-date without manual intervention.

Properties

Name Meaning
Authentication Method of authenticating API requests. Options: Tenant Token, OAuth2
Calendar Id The unique identifier of the calendar containing the event to be deleted.
Event Id The unique identifier of the event to delete within the specified calendar.
Options Additional optional settings. Currently supports: Use Custom Body (boolean) — whether to send a custom request body instead of the default.

Output

The node outputs JSON data representing the response from the Lark Calendar API after attempting to delete the event. Typically, this will include status information indicating success or failure of the deletion operation.

If the node supports binary data output, it would generally relate to attachments or files associated with calendar events, but for the delete operation, no binary output is expected.

Dependencies

  • Requires access to the Lark Suite Open APIs.
  • Needs either a Tenant Token or OAuth2 credentials configured in n8n for authentication.
  • The base URL for API requests is https://open.larksuite.com/open-apis.
  • Proper permissions on the provided credentials to delete calendar events.

Troubleshooting

  • Common Issues:

    • Invalid or expired authentication tokens can cause authorization failures.
    • Incorrect Calendar Id or Event Id will result in errors indicating the resource was not found.
    • Insufficient permissions on the API credentials may prevent deletion.

  • Error Messages:

    • 401 Unauthorized: Check that the authentication credentials are valid and have not expired.
    • 404 Not Found: Verify that the Calendar Id and Event Id are correct and exist.
    • 403 Forbidden: Ensure the authenticated user has permission to delete events in the specified calendar.

  • Resolution Tips:

    • Refresh or reconfigure authentication credentials if unauthorized.
    • Double-check IDs against the Lark Calendar UI or API documentation.
    • Confirm API scopes and permissions granted to the credentials.

Links and References

Discussion