Actions21
Overview
This node interacts with the Financial Cents API to manage client resources. Specifically, the Client Resource - List operation retrieves a list of resources associated with a particular client. These resources typically represent labeled URLs or documents linked to a client.
Common scenarios where this node is beneficial include:
- Fetching all resource links or attachments related to a client for reporting or processing.
- Filtering client resources by label to find specific documents or references.
- Sorting client resources by creation date, label, or custom index to organize data presentation.
For example, a user might use this node to automatically retrieve all contract documents (stored as client resources) labeled "Contract" for a given client and then process or archive them.
Properties
| Name | Meaning |
|---|---|
| Debug: Include Raw Response | If enabled, each returned item will include the full raw JSON response from the API under __raw. Useful for debugging or accessing additional data fields not explicitly parsed. |
| Client | The client to operate on. This is selected from a dynamically loaded list of clients. |
| Search Label | Filter client resources by their label. Only resources whose label matches this string will be returned. |
| Order By | Field to order the results by. Options are: List Index, Created At, Label, ID. |
| Order Direction | Direction to order the results: Ascending or Descending. |
Output
The output consists of an array of JSON objects, each representing a client resource. Each object contains fields describing the resource such as its label, URL, creation date, and ID. If the debug option is enabled, each item also includes a __raw field containing the full raw API response for that item.
No binary data is output by this operation.
Example output item (simplified):
{
"id": "resource-id-123",
"label": "Contract",
"url": "https://example.com/contract.pdf",
"created_at": "2023-01-01T12:00:00Z"
}
If debug is enabled:
{
"id": "resource-id-123",
"label": "Contract",
"url": "https://example.com/contract.pdf",
"created_at": "2023-01-01T12:00:00Z",
"__raw": { /* full raw API JSON response */ }
}
Dependencies
- Requires an API key credential for authenticating with the Financial Cents API.
- The node uses HTTP requests to the Financial Cents API endpoints.
- No additional environment variables are required beyond the API credential.
- The client list used in the "Client" property is dynamically loaded via the API.
Troubleshooting
- Empty results: Ensure the correct client is selected and that the client has resources. Also verify any search label filter is accurate.
- API authentication errors: Confirm the API key credential is valid and has necessary permissions.
- Rate limiting or pagination issues: The node handles pagination internally but if limits are set too low, fewer results may be returned.
- Missing client selection: The "Client" property must be set; otherwise, the API call will fail or return no data.
- Invalid order or filter values: Use only the provided options for ordering and filtering to avoid API errors.
Links and References
- Financial Cents API Documentation (general reference for API endpoints)
- n8n documentation on HTTP Request Authentication (for understanding how credentials work)
This summary covers the static analysis of the Client Resource List operation based on the provided source code and properties.