Actions12
Overview
The Staff - Get operation in this custom n8n node allows you to retrieve staff member information from the Accelo API. This is useful for automating HR, team management, or administrative workflows where you need to fetch details about employees or users registered as staff in your Accelo account. For example, you might use this node to:
- Retrieve a specific staff member's profile by ID, email, or username.
- Filter staff based on their standing (active, inactive, lockout).
- Optionally include additional profile data for richer automation scenarios.
Properties
| Name | Meaning |
|---|---|
| Get Profile Data | Whether to get additional profile data. If enabled, the response will include more detailed information about the staff member(s). |
| Filters | A collection of filters to narrow down the staff search: |
| - Staff ID: Numeric ID of the staff member. | |
| - Email: Email address of the staff member (e.g., name@email.com). | |
| - Username: Username of the staff member. | |
- Standing: Status of the staff member; options are Active, Inactive, or Lockout. |
Output
The output is a JSON object (or array of objects) representing the staff member(s) matching the provided filters. The structure typically includes fields such as:
{
"id": 123,
"email": "staff@example.com",
"username": "jdoe",
"standing": "active",
// ...other standard staff fields
"profile": {
// ...additional profile data if 'Get Profile Data' is enabled
}
}
- If "Get Profile Data" is enabled, the
profilefield will contain further nested details. - No binary data is produced by this operation.
Dependencies
- External Service: Requires access to the Accelo API.
- API Credentials: You must configure an
acceloApicredential in n8n with appropriate permissions. - n8n Configuration: Ensure the node is properly authenticated and that the Accelo API base URL is set if required.
Troubleshooting
Invalid Credentials:
Error Message: "401 Unauthorized" or similar.
Resolution: Check that youracceloApicredentials are correct and have sufficient permissions.No Results Returned:
Possible Cause: Filters may be too restrictive or not match any staff records.
Resolution: Double-check filter values (ID, email, username, standing).Missing Required Fields:
Error Message: "Missing required parameter" or similar.
Resolution: Ensure at least one identifying filter (ID, email, or username) is provided.API Rate Limits:
Error Message: "429 Too Many Requests".
Resolution: Wait before retrying or contact Accelo support for rate limit increases.