Actions21
Overview
This node integrates with the Financial Cents API to manage project resources, specifically allowing users to assign or remove users as resources on projects. The "Create" operation for the "Project Resource" resource assigns a user to a specified project by their user ID.
Common scenarios where this node is beneficial include:
- Automating team assignments in project management workflows.
- Integrating user assignment into broader automation pipelines, such as onboarding or task allocation.
- Synchronizing project resource assignments from other systems into Financial Cents.
For example, you can use this node to automatically add a new team member to a project when they are added to your HR system, ensuring that project roles stay up-to-date without manual intervention.
Properties
| Name | Meaning |
|---|---|
| Debug: Include Raw Response | If enabled, each output item will include the full raw JSON response from the API under __raw. Useful for debugging. |
| Use /projects path (not /work) | Toggle to use /projects endpoint path instead of /work in the API URL. Enable if your API version uses /projects. |
| Project | The project to which the resource (user) will be assigned. Select from available projects. |
| User ID | The ID of the user to assign as a resource to the selected project. This is required for creating a project resource. |
Output
The node outputs an array of JSON objects representing the created project resource assignment. Each object contains the details returned by the Financial Cents API about the newly assigned resource.
If "Debug: Include Raw Response" is enabled, the output JSON object also includes a __raw field containing the complete raw API response for deeper inspection.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for authenticating with the Financial Cents API.
- The node makes HTTP requests to the Financial Cents API endpoints, so network access to the API is necessary.
- Optionally, the API base URL can be customized via credentials; otherwise, it defaults to
https://app.financial-cents.com/api/v1. - The node supports two API paths for projects:
/work(default) and/projects(toggleable).
Troubleshooting
- Missing User ID: If the "User ID" property is not provided when creating a project resource, the node throws an error: "User ID is required to create a project resource." Ensure this field is filled with a valid user identifier.
- Invalid Project ID: Selecting a non-existent or unauthorized project may cause API errors. Verify the project exists and the API credentials have permission.
- API Path Mismatch: If your Financial Cents API uses
/projectsinstead of/work, enable the "Use /projects path" option; otherwise, requests may fail. - Network or Authentication Errors: Check that the API key credential is correctly configured and that the network allows outbound HTTPS requests to the Financial Cents API.
- Unexpected API Responses: Enabling "Debug: Include Raw Response" helps diagnose issues by exposing the full API response.
Links and References
- Financial Cents API Documentation (for detailed API endpoint info)
- n8n Documentation on Creating Custom Nodes
- General REST API troubleshooting tips: verify credentials, check endpoint URLs, and inspect raw responses.