Lark Calendar icon

Lark Calendar

Lark Calendar Management

Overview

The "Create A Calendar" operation in the Lark Calendar node allows users to create a new calendar within their Lark workspace. This is useful for automating calendar management tasks such as setting up team calendars, project-specific schedules, or personal event tracking. For example, a user can automatically generate a calendar for a new project and share it with relevant team members, streamlining collaboration and scheduling.

Properties

Name Meaning
Authentication Method of authenticating API requests; options are "Tenant Token" or "OAuth2".
Color Numeric value representing the calendar's color theme.
Description Text description providing details about the calendar.
Permissions String defining access permissions for the calendar.
Summary Title or summary name of the calendar.
Summary Alias Alternative short name or alias for the calendar.
Custom Body JSON object allowing full customization of the request body sent to the API.
Use Custom Body Boolean flag indicating whether to send the custom JSON body instead of individual fields.

Output

The node outputs JSON data representing the newly created calendar resource as returned by the Lark Calendar API. This typically includes identifiers, metadata such as color, description, permissions, summary, and other calendar attributes. The output does not include binary data.

Dependencies

  • Requires authentication via either a Tenant Token or OAuth2 credentials.
  • Connects to the Lark Suite Open APIs at https://open.larksuite.com/open-apis.
  • Proper configuration of credentials in n8n is necessary to authorize API calls.

Troubleshooting

  • Authentication errors: Ensure that the selected authentication method (Tenant Token or OAuth2) is correctly configured and valid.
  • Invalid property values: Verify that numeric fields like "Color" are within acceptable ranges defined by the API.
  • API errors due to malformed requests: If using the "Custom Body" option, ensure the JSON structure matches the API specification.
  • Permission issues: Confirm that the authenticated user has rights to create calendars in the target workspace.

Links and References

Discussion