Lark Calendar icon

Lark Calendar

Lark Calendar Management

Actions32

Overview

The "Create Event Invitees" operation in the "Event Attendee" resource of the Lark Calendar node allows users to add attendees to a specific calendar event. This is useful for automating the process of inviting participants to meetings or events managed within Lark Calendar. For example, you can use this node to programmatically invite team members to a project kickoff meeting or send invites to clients for scheduled calls.

Properties

Name Meaning
Authentication Method of authentication to use when connecting to Lark Calendar API. Options: Tenant Token, OAuth2.
Calendar Id The unique identifier of the calendar where the event exists. Required to specify which calendar's event will receive the invitees.
Event Id The unique identifier of the event to which attendees will be added.
Attendees A collection of attendee objects to add to the event. Each item is a JSON object describing an individual attendee with customizable fields such as user ID, email, chat ID, and other options.
Instance Start Time Admin (Optional) A string representing the start time of the event instance for administrative purposes.
Is Enable Admin Boolean flag indicating whether admin privileges are enabled for this operation. Defaults to true.
Need Notification Boolean flag indicating whether notifications should be sent to the attendees upon invitation. Defaults to true.
Custom Body Allows sending a fully custom JSON body for the request instead of using the standard properties. Useful for advanced use cases where the default structure does not suffice.
Options → Use Custom Body Boolean flag to toggle between using the standard input properties or providing a custom JSON body.

Output

The node outputs JSON data representing the response from the Lark Calendar API after attempting to create event invitees. This typically includes details about the attendees added, confirmation statuses, or error messages if the operation failed. The output does not include binary data.

Dependencies

  • Requires access to the Lark Suite API.
  • Needs either a Tenant Token or OAuth2 credentials configured in n8n to authenticate API requests.
  • The base URL for API requests is https://open.larksuite.com/open-apis.
  • Proper permissions on the calendar and event are necessary to add attendees.

Troubleshooting

  • Invalid Calendar or Event ID: If the provided calendar or event ID is incorrect or does not exist, the API will return an error. Verify IDs carefully.
  • Authentication Errors: Using invalid or expired tokens will cause authentication failures. Ensure that the API credentials are valid and have not expired.
  • Permission Denied: Lack of sufficient permissions to modify the event or add attendees will result in errors. Confirm that the authenticated user has appropriate rights.
  • Malformed Attendee Data: Providing incorrectly structured attendee JSON objects may cause the request to fail. Validate the JSON format and required fields.
  • Notification Issues: If notifications are disabled but expected, check the Need Notification property setting.

Links and References

Discussion