Financial Cents

Interact with the Financial Cents API

Actions21

Overview

This node interacts with the Financial Cents API to manage resources related to projects, clients, contacts, templates, and roles. Specifically, for the Project Resource with the List operation, it retrieves a list of resources (users) assigned to a specified project. This is useful for scenarios where you want to automate or integrate workflows that require fetching all users involved in a particular project, such as generating reports, syncing user assignments with other systems, or managing project team members programmatically.

For example, you might use this node to:

  • Retrieve all users assigned to a project to notify them about updates.
  • Sync project resource assignments with an external HR or project management tool.
  • Audit project team composition regularly.

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 not explicitly parsed by the node.
Use /projects path (not /work) Select this if your Financial Cents API uses the /projects endpoint path instead of /work. This changes the base path used for project-related API calls.
Project The specific project to operate on. You select the project whose resources you want to list.
Page The page number of results to fetch when paginating through project resources. Minimum is 1.
Per Page Number of records per page to retrieve. Must be between 1 and 200.
Return All If true, the node will automatically paginate through all pages to return all project resources.
Limit When "Return All" is enabled, this limits the maximum number of records to return. Zero means no limit.

Output

The output is an array of JSON objects representing project resources (users) assigned to the specified project. Each item corresponds to one resource and contains fields as returned by the Financial Cents API, such as user IDs and any associated metadata.

If the "Debug: Include Raw Response" option is enabled, each item will also contain a __raw field holding the complete raw API response for that item, which can be useful for troubleshooting or accessing additional data fields not directly exposed.

The node does not output binary data.

Dependencies

  • Requires an API key credential for the Financial Cents API configured in n8n.
  • The node makes HTTP requests to the Financial Cents API endpoints, so network connectivity to the API service is required.
  • Optionally, the API base URL can be customized via credentials; otherwise, it defaults to https://app.financial-cents.com/api/v1.

Troubleshooting

  • Missing Project ID: If the "Project" property is not set, the node cannot list resources and will likely fail. Ensure a valid project is selected.
  • User ID Required for Create/Delete: For operations other than list (create/delete), a User ID must be provided; otherwise, the node throws an error.
  • API Path Mismatch: If your API uses /projects instead of /work, enable the "Use /projects path" option to avoid 404 errors.
  • Pagination Limits: If "Return All" is enabled but the limit is set too low, fewer results than expected may be returned.
  • API Authentication Errors: Ensure the API key credential is correctly configured and has sufficient permissions.
  • Rate Limiting: If many pages are requested, the API might throttle requests. Implement delays or reduce page size if needed.

Links and References


This summary focuses on the Project Resource with the List operation as requested. Other resources and operations exist but are outside the scope of this extraction.

Discussion