Lark Calendar icon

Lark Calendar

Lark Calendar Management

Overview

The "Subscribe To Calendar Change Events" operation in the Lark Calendar node allows users to subscribe to real-time notifications about changes occurring in a calendar. This is useful for applications that need to react immediately when events are created, updated, or deleted within a calendar managed by Lark Suite.

Common scenarios include:

  • Synchronizing calendar events with another system or application.
  • Triggering workflows or alerts when calendar events change.
  • Keeping a custom dashboard or interface up-to-date with live calendar data.

For example, a user could set up this subscription to automatically update a project management tool whenever a meeting is scheduled or modified in their Lark Calendar.

Properties

Name Meaning
Authentication Method of authenticating API requests. Options: "Tenant Token" or "OAuth2".
Use Custom Body Boolean flag indicating whether to send a custom JSON body in the subscription request.
Custom Body A JSON object representing the custom request body to send if "Use Custom Body" is true.

Output

The node outputs JSON data representing the response from the subscription API call. This typically includes details confirming the subscription status and any relevant metadata returned by the Lark Calendar API.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to Lark Suite's Open APIs.
  • Needs either a Tenant Token or OAuth2 authentication credential configured in n8n.
  • The base URL for API requests is https://open.larksuite.com/open-apis.

Troubleshooting

  • Authentication errors: Ensure that the selected authentication method (Tenant Token or OAuth2) is correctly configured and valid.
  • Invalid custom body: If using a custom body, verify that the JSON structure matches the expected schema of the Lark Calendar subscription API.
  • Network issues: Confirm network connectivity to open.larksuite.com and that no firewall or proxy is blocking requests.
  • API limits or permissions: Check that the API credentials have sufficient permissions to subscribe to calendar events.

Links and References

Discussion