Lark Attendance icon

Lark Attendance

Lark Attendance Management

Actions22

Overview

The node "Lark Attendance" provides functionality to manage attendance-related user settings within the Lark platform. Specifically, the "Modify User Settings" operation under the "User Setting" resource allows users to update specific attributes related to a user's attendance profile, such as face recognition keys or user identifiers.

This node is beneficial in scenarios where an organization needs to programmatically update or synchronize user attendance settings, for example:

  • Updating a user's facial recognition key used for attendance verification.
  • Changing or correcting user IDs linked to attendance records.
  • Integrating with HR systems to keep attendance data consistent.

Practical examples include automating updates when employees change departments or roles, or when onboarding new employees and setting up their attendance profiles.

Properties

Name Meaning
Authentication Method of authenticating API requests. Options: Tenant Token, OAuth2
Employee Type Specifies the type of employee ID used in the request and response (e.g., internal ID, email)
User Setting Collection of user setting fields to modify. Includes:
- face_key: Face recognition key
- user_id: Identifier of the user
Custom Body JSON object allowing full customization of the request body sent to the API
Options > Use Custom Body Boolean flag to determine whether to send a custom JSON body instead of the structured fields

Output

The node outputs JSON data representing the response from the Lark Attendance API after modifying the user settings. This typically includes confirmation of the updated user settings, reflecting fields such as face_key and user_id, along with any metadata returned by the API.

No binary data output is involved in this operation.

Dependencies

  • Requires authentication via either a Tenant Token or OAuth2 credentials configured in n8n.
  • Connects to the Lark Suite Open APIs endpoint at https://open.larksuite.com/open-apis.
  • Proper permissions on the Lark platform are necessary to modify user attendance settings.

Troubleshooting

  • Authentication errors: Ensure that the selected authentication method is correctly configured with valid credentials and has sufficient permissions.
  • Invalid user_id or face_key: Verify that the user identifiers and face keys provided exist and conform to expected formats.
  • API rate limits or network issues: Check connectivity and API usage quotas on the Lark platform.
  • Custom Body format errors: When using the custom body option, ensure the JSON structure matches the API specification exactly to avoid request failures.

Links and References

Discussion