Financial Cents

Interact with the Financial Cents API
Join our community

Actions21

Overview

This node integrates with the Financial Cents API to manage contacts associated with clients. Specifically, the Contact - Create operation allows users to create a new contact under a specified client in Financial Cents. This is useful for automating contact management workflows such as adding new client contacts from form submissions, CRM systems, or other data sources.

Practical examples include:

  • Automatically adding a new contact person when onboarding a client.
  • Syncing contact details from external databases into Financial Cents.
  • Creating contacts as part of a larger workflow that manages client projects and resources.

Properties

Name Meaning
Debug: Include Raw Response If enabled, the raw JSON response from the Financial Cents API will be included in output under __raw. Useful for debugging API responses.
Client The parent client under which the contact will be created. Select from existing clients.
Name The full name of the contact to create. (Required)
Email The email address of the contact.
Address The physical address of the contact.
Notes Additional notes about the contact.

Output

The node outputs an array of items where each item contains a json object representing the newly created contact's data as returned by the Financial Cents API. If "Debug: Include Raw Response" is enabled, the raw API response JSON is also included under the __raw property within each item.

The output JSON typically includes fields such as:

  • Contact ID
  • Name
  • Email
  • Address
  • Notes
  • Other metadata provided by the API

No binary data is produced by this operation.

Dependencies

  • Requires an active connection to the Financial Cents API via an API key credential configured in n8n.
  • The node uses HTTP requests authenticated against the Financial Cents API base URL.
  • The "Client" property depends on loading available clients from the API, so the user must have access rights to list clients.

Troubleshooting

  • Missing Client Selection: The "Client" field is mandatory to create a contact. Ensure a valid client is selected; otherwise, the API call will fail.
  • Required Fields: The "Name" property is required. Omitting it will cause an error.
  • API Authentication Errors: If the API key credential is invalid or missing, requests will fail with authentication errors. Verify the API key and permissions.
  • Rate Limits or Network Issues: The node relies on network connectivity and API availability. Temporary failures may occur due to rate limits or downtime.
  • Invalid Email Format: While not explicitly validated here, providing an invalid email might cause API-side validation errors.

Links and References

Discussion