Lark Attendance

Lark Attendance Management

Actions22

Attendance Group Actions
Attendance Shift Actions
Attendance Schedule Actions
- Query Schedule Information
- Create Or Modify Schedule
Attendance Statistic Actions
Attendance Record Actions
Attendance Correction Actions
- Obtain Correction Record
User Setting Actions
- Modify User Settings
File Actions
- Upload Files
Task Actions
- Get User Attendance Data
- Add Approved Data In Feishu Attendance

Overview

The "Search Shift By Name" operation in the Attendance Shift resource allows users to query and retrieve attendance shift details by specifying a shift name. This node is useful for organizations managing employee attendance schedules who want to quickly find shifts matching a particular name, for example, to verify shift configurations or to integrate shift data into other workflows.

Practical examples include:

Automatically fetching shift details when an employee requests their schedule.
Integrating with HR systems to validate shift names before assigning employees.
Generating reports based on specific shifts by name.

Properties

Name	Meaning
Authentication	Method of authenticating API requests; options are "Tenant Token" or "OAuth2".
Shift Name	The exact name of the attendance shift to search for.
Use Custom Body	Boolean flag indicating whether to send a custom JSON body instead of the default query.
Custom Body	A JSON object representing a custom request body to send if "Use Custom Body" is enabled.

Output

The node outputs JSON data containing the search results for the specified shift name. The structure typically includes details about the matched attendance shifts such as shift identifiers, names, timings, and other metadata provided by the Lark Attendance API.

If binary data were involved (not indicated here), it would represent files or attachments related to shifts, but this operation focuses on JSON data only.

Dependencies

Requires access to the Lark Suite Open APIs for attendance management.
Needs either a Tenant Token or OAuth2 authentication configured in n8n credentials.
Network connectivity to https://open.larksuite.com/open-apis.

Troubleshooting

Empty or no results: Ensure the "Shift Name" is correctly spelled and exists in the attendance system.
Authentication errors: Verify that the selected authentication method is properly configured and the token or OAuth credentials are valid and not expired.
API rate limits or network issues: Check network connectivity and API usage quotas.
Invalid custom body: If using the custom body option, ensure the JSON is well-formed and matches the expected API schema.