Runn icon

Runn

Interact with Runn.io API

Overview

This node integrates with a service to manage and retrieve data related to business entities such as clients, people, and projects. Specifically, for the Clients resource with the Get All operation, it fetches a list of all client records from the connected system.

Common scenarios where this node is beneficial include:

  • Synchronizing client lists from an external CRM or project management tool into n8n workflows.
  • Generating reports or dashboards that require up-to-date client information.
  • Automating follow-ups or notifications based on client status.

For example, you could use this node to pull all active clients and then trigger personalized email campaigns or update other systems with the latest client data.

Properties

Name Meaning
Only Active Boolean flag indicating whether to return only active clients (true) or all clients (false).
Options A collection placeholder for additional optional parameters (currently empty in definition).

Output

The node outputs an array of JSON objects representing clients. Each object contains the client's data fields as provided by the external service's API.

  • The json output field includes client details such as name, status, contact info, and any other attributes returned by the API.
  • There is no indication that binary data is output by this node.

Dependencies

  • Requires connection to the external service's API via an authenticated API client instance.
  • The node internally calls a shared base method to obtain the API client.
  • Proper API credentials must be configured in n8n to authorize requests.

Troubleshooting

  • Unsupported resource error: If the resource parameter is set incorrectly, the node throws an error stating the resource is unsupported. Ensure "Clients" is selected as the resource.
  • API authentication errors: Failure to authenticate with the external service will cause request failures. Verify that API credentials are correctly set up.
  • Empty results: If "Only Active" is set to true but no active clients exist, the output will be an empty array.
  • Continue on Fail: If enabled, the node returns error messages inside the output JSON instead of failing the workflow.

Links and References

  • Refer to the external service's API documentation for detailed client data schema and filtering options.
  • Consult n8n documentation on setting up API credentials and using the "Continue on Fail" feature.

Discussion