Runn icon

Runn

Interact with Runn.io API

Overview

This node interacts with a service managing Clients, Projects, and People resources. Specifically for the Clients resource with the Get One operation, it retrieves detailed information about a single client identified by its unique ID. This is useful in scenarios where you need to fetch client details for display, processing, or integration with other systems.

For example, you might use this node to:

  • Retrieve a client's profile before updating their information.
  • Fetch client data to generate reports or dashboards.
  • Access client details to link them with projects or people records.

Properties

Name Meaning
ID The unique identifier of the client to retrieve. This is required to specify which client to fetch.
Options A collection of additional optional parameters that can modify the request behavior (currently no specific options defined).

Output

The output contains an array of JSON objects representing the client data retrieved from the external service. Each object corresponds to one client record with all its associated fields as returned by the API.

If the node supports binary data output (not indicated here), it would typically represent attachments or files related to the client, but this is not evident from the provided code.

Dependencies

  • Requires access to the external API service managing clients, projects, and people.
  • Needs an API authentication token or key configured in n8n to authorize requests.
  • Depends on internal helper modules (clients.operations) to perform the actual API call for client operations.

Troubleshooting

  • Error: Unsupported resource — Occurs if an invalid resource name is provided; ensure "clients" is selected for this operation.
  • Missing ID parameter — The node requires the client ID to fetch a specific client; verify that the ID field is correctly set.
  • API errors — If the external service returns errors (e.g., client not found, unauthorized), these will be thrown unless "Continue On Fail" is enabled, in which case error details are returned in the output JSON.
  • Network or authentication issues — Ensure the API credentials are valid and network connectivity to the service is available.

Links and References

  • No direct links available from the source code.
  • Refer to the external API documentation of the client management service for detailed schema and supported query options.

Discussion