Actions11
Overview
This node integrates with Zoho Bookings to retrieve information about staff members. Specifically, the "Get Staff" operation under the "Other" resource allows users to fetch details about staff in different ways:
- Retrieve all staff.
- Retrieve a specific staff member by their Staff ID.
- Retrieve all staff assigned to a particular service by Service ID.
This node is useful for scenarios where you need to manage or display staff information dynamically, such as syncing staff data with other systems, displaying staff availability, or automating workflows based on staff assignments.
Practical examples:
- Fetching all staff members in a workspace to populate a dropdown list in a booking form.
- Getting detailed information about a specific staff member to personalize communications.
- Listing all staff assigned to a service to allocate appointments or send notifications.
Properties
| Name | Meaning |
|---|---|
| Search Type | Method to search staff: - All Staff - By Staff ID (gets details of one staff member) - By Service ID (gets all staff assigned to a service) |
| Workspace ID | The identifier of the workspace (required for some search types, but not shown for "Get Staff" operation here) |
| Service ID | The identifier of the service; used when searching staff by service ID |
| Staff ID | The identifier of the staff member; used when searching by staff ID |
| Additional Fields | Optional extra parameters: - Zoho Region: Selects the regional domain for API requests (e.g., .com, .eu, .in, .com.au, .com.cn) |
Output
The output JSON contains a field named staffInfo which holds the retrieved staff data from Zoho Bookings. The structure depends on the search type:
- For "All Staff": an array of staff objects representing all staff members.
- For "By Staff ID": a single staff object with detailed information about that staff member.
- For "By Service ID": an array of staff objects assigned to the specified service.
Each staff object typically includes identifiers, names, contact details, and possibly other metadata as provided by the Zoho Bookings API.
No binary data output is produced by this operation.
Dependencies
- Requires an OAuth2 API credential configured for Zoho Bookings to authenticate API requests.
- Uses the Zoho Bookings API endpoint, which varies by region (selected via the "Zoho Region" property).
- Relies on helper functions imported from bundled dependencies for making authenticated HTTP requests and fetching staff data.
Troubleshooting
- Missing or invalid Staff ID / Service ID: Ensure that the IDs provided are correct and correspond to existing entities in Zoho Bookings.
- Authentication errors: Verify that the OAuth2 credentials are correctly set up and have the necessary permissions.
- Region mismatch: If the API returns errors related to endpoints, check that the selected Zoho Region matches your Zoho account's region.
- Empty results: If no staff data is returned, confirm that the workspace/service/staff exists and has associated staff members.
- API rate limits: Be aware of Zoho API rate limits which might cause temporary failures.
Common error messages will be thrown as node execution errors with context about the failing item index, helping identify which input caused the issue.