Lark Calendar icon

Lark Calendar

Lark Calendar Management

Actions32

Overview

The "Delete Event Invitees" operation in the "Event Attendee" resource of the Lark Calendar node allows users to remove one or more attendees from a specific calendar event. This is useful for managing event participation dynamically, such as when invitees cancel their attendance or need to be removed due to changes in event planning.

Typical use cases include:

  • Automatically updating event attendee lists by removing canceled participants.
  • Managing large events where attendee lists change frequently.
  • Integrating with other systems to synchronize event participation status.

For example, an organization might use this node to programmatically remove attendees who have declined an invitation or to clean up event invites after a deadline.

Properties

Name Meaning
Authentication Method of authentication to access the API. Options: Tenant Token, OAuth2.
Calendar Id The unique identifier of the calendar containing the event. Required to specify which calendar's event is being modified.
Event Id The unique identifier of the event from which attendees will be deleted.
Attendee Ids A collection of attendee IDs representing the invitees to be removed from the event. Multiple attendee IDs can be specified.
Instance Start Time Admin (Optional) A string representing the start time of the event instance in admin format. Used when dealing with recurring events to specify which instance is affected.
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 removed attendees. Defaults to true.
Custom Body Allows sending a fully custom JSON body instead of using the predefined properties. Useful for advanced scenarios or when the user wants full control over the request payload.
Use Custom Body Option to toggle between using the standard input properties or providing a custom JSON body. When enabled, the node sends the Custom Body content as the request payload instead of the structured fields above.

Output

The node outputs JSON data representing the response from the Lark Calendar API after attempting to delete the specified event invitees. The structure typically includes confirmation of success or failure and may contain details about the updated event or error messages.

If the operation succeeds, the output confirms that the specified attendees were removed. If it fails, the output contains error information explaining why the deletion did not occur.

This node does not output binary data.

Dependencies

  • Requires valid authentication credentials via either a Tenant Token or OAuth2 token to access the Lark Calendar API.
  • Needs network connectivity to the Lark Suite open APIs endpoint (https://open.larksuite.com/open-apis).
  • Proper configuration of credentials within n8n is necessary before using this node.

Troubleshooting

  • Common Issues:

    • Invalid or expired authentication tokens will cause authorization errors.
    • Incorrect Calendar ID or Event ID will result in "not found" errors.
    • Providing invalid or empty attendee IDs will prevent deletion.
    • Attempting to delete attendees from a recurring event without specifying the instance start time may lead to unexpected behavior.

  • Error Messages:

    • Unauthorized / 401: Check that the API credentials are correctly configured and have not expired.
    • Not Found / 404: Verify that the Calendar ID and Event ID are correct and exist.
    • Bad Request / 400: Ensure that the attendee IDs are valid and properly formatted.
    • Forbidden / 403: Confirm that the authenticated user has sufficient permissions to modify the event.

  • Resolution Tips:

    • Double-check all IDs and ensure they match those in the Lark Calendar system.
    • Use the "Need Notification" flag carefully; some configurations may restrict sending notifications.
    • When working with recurring events, always specify the Instance Start Time Admin if you want to target a specific occurrence.

Links and References

Discussion