Financial Cents

Interact with the Financial Cents API
Join our community

Actions21

Overview

This node interacts with the Financial Cents API to manage clients and related data. Specifically, the Client - List operation fetches a list of clients from the Financial Cents system. It supports pagination, sorting, searching, and can optionally return all clients by auto-paginating through all available pages.

Typical use cases include:

  • Retrieving a paginated or complete list of clients for reporting or synchronization.
  • Filtering clients by name using various search operations (equals, begins with, ends with, contains).
  • Sorting clients by name or creation date in ascending or descending order.
  • Debugging API responses by including raw JSON data.

Example: A user wants to get all clients whose names contain "Acme", sorted by creation date descending, and process them in an automation workflow.

Properties

Name Meaning
Debug: Include Raw Response If enabled, each returned client item will include the full raw API JSON response under __raw.
Page The page number of results to fetch (minimum 1).
Per Page Number of client records per page (1 to 200).
Order By Field to sort clients by: Name or Created At.
Order Direction Sort direction: Ascending or Descending.
Enable Search Enable filtering clients by a search query.
Search Field Field to search on when search is enabled: currently only Name.
Search Operation Type of string matching for search: Equals, Begins With, Ends With, or Contains.
Search Value The string value to search for in the selected field.
Return All If true, automatically paginate through all pages until all clients are retrieved.
Limit When Return All is true, limits the maximum number of clients to return (0 means no limit).

Output

The output is an array of items, each representing a client object returned by the Financial Cents API. Each item has a json property containing the client data fields as provided by the API.

If "Debug: Include Raw Response" is enabled, each item also includes a __raw property containing the full raw JSON response from the API for that request.

The structure of each client object typically includes fields such as client ID, display name, creation date, and other metadata as returned by the API.

No binary data is output by this node.

Dependencies

  • Requires an API key credential for authenticating with the Financial Cents API.
  • The base URL defaults to https://app.financial-cents.com/api/v1 but can be configured via credentials.
  • Uses HTTP requests with authentication handled internally by n8n's credential system.

Troubleshooting

  • Empty results: Ensure the correct page and per-page values are set. If searching, verify the search value and field are correct.
  • API errors: Check that the API key credential is valid and has sufficient permissions.
  • Pagination issues: If Return All is enabled but fewer clients than expected are returned, check the Limit setting.
  • Missing required parameters: For example, if you enable search but leave the search value empty, no filtering will occur.
  • Error messages about missing IDs: This operation does not require client IDs, but other operations might; ensure parameters match the operation.

Links and References

If you need details on other operations or resources, feel free to ask!

Discussion