Actions21
Overview
This node integrates with the Financial Cents API to manage client resources. Specifically, the Client Resource - Create operation allows users to create a new resource associated with a client by providing a label and a URL for that resource.
Typical use cases include:
- Adding external documents, links, or references related to a client in your financial management workflow.
- Storing URLs to client-specific resources such as contracts, reports, or other relevant files accessible via a web link.
- Automating the creation of client resources when onboarding new clients or updating client profiles programmatically.
For example, you might use this node to automatically add a link to a client's online profile or a shared folder URL whenever a new client is created in your system.
Properties
| Name | Meaning |
|---|---|
| Debug: Include Raw Response | If enabled, the raw JSON response from the API will be included in each output item under the __raw property. Useful for debugging or inspecting full API responses. |
| Client | The client to which the resource will be added. This is selected from existing clients loaded dynamically. |
| Label | The descriptive label for the client resource being created. For example, "Contract Document" or "Project Plan Link". |
| URL | The URL pointing to the resource associated with the client. This should be a valid web address or link to the resource. |
Output
The node outputs an array of items where each item contains a json object representing the created client resource. The structure includes at least the properties returned by the Financial Cents API for the newly created resource, such as its ID, label, URL, and any other metadata.
If the "Debug: Include Raw Response" option is enabled, each output item will also contain a __raw field holding the complete raw JSON response from the API call, which can be useful for troubleshooting or advanced processing.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the Financial Cents API using an API key credential configured in n8n.
- The node uses HTTP requests authenticated via this credential to interact with the Financial Cents API endpoints.
- The client list must be available (loaded) to select the target client for the resource creation.
Troubleshooting
- Missing Client Selection: If no client is selected, the node cannot create a resource. Ensure the "Client" property is set correctly.
- Invalid URL or Label: Providing empty or invalid values for the "Label" or "URL" fields may cause the API to reject the request. Verify these inputs before execution.
- API Authentication Errors: If the API key credential is missing, expired, or incorrect, the node will fail to authenticate. Check the credential configuration in n8n.
- Network Issues: Connectivity problems between n8n and the Financial Cents API endpoint can cause timeouts or errors. Confirm network access and API availability.
- Unexpected API Responses: Enabling the debug option helps capture raw API responses, which can assist in diagnosing issues related to unexpected data or error messages.
Links and References
- Financial Cents API Documentation (general reference for API endpoints and data structures)
- n8n Documentation on Creating Custom Nodes (for understanding node development concepts)
This summary focuses exclusively on the Client Resource - Create operation as requested, based on static analysis of the provided source code and input property definitions.