Overview
This node connects to an n8n instance and retrieves information about credentials used across workflows. It can list all credentials, group them by workflow, or provide a unique set of credentials with usage counts. This is useful for administrators or users who want to audit credential usage, identify unused credentials, or understand which workflows and nodes rely on specific credentials.
Practical examples:
- Auditing all credentials currently in use across your n8n workflows.
- Grouping credentials by workflow to see which credentials each workflow depends on.
- Getting a unique list of credentials with how many times each is used, helping to clean up unused credentials.
Properties
| Name | Meaning |
|---|---|
| n8n Base URL | The base URL of the n8n instance to connect to (e.g., http://localhost:5678). |
| Include Workflow Details | Whether to include workflow name, ID, and active status in the output (true/false). |
| Include Node Details | Whether to include node name and type that uses the credential in the output (true/false). |
| Skip SSL Verification | Whether to skip SSL certificate verification when connecting to the n8n instance (true/false). Useful for local development with self-signed certificates. |
Output
The node outputs JSON objects describing credentials found in workflows. The structure varies depending on the selected operation:
List All Workflow Credentials:
Outputs individual entries per credential usage with fields such as:credentialId: The ID of the credential.credentialType: The type/category of the credential.- Optionally (if enabled):
workflowId,workflowName,workflowActive— details about the workflow using the credential.nodeName,nodeType— details about the node using the credential.
List Credentials by Workflow:
Outputs grouped data per workflow, each containing:workflowId,workflowName,workflowActivecredentials: An array of credentials used in that workflow, each with:credentialId,credentialType- Optionally
nodeName,nodeTypeif node details are included.
Get Unique Credentials:
Outputs unique credentials with their total usage count across all workflows:credentialIdtotalUsage: Number of times this credential is used in workflows.
If no credentials are found, the node outputs a message indicating no credentials were found along with the total number of workflows scanned.
The node does not output binary data.
Dependencies
- Requires access to the n8n REST API endpoint
/rest/workflowson the specified n8n instance. - No authentication is required to fetch workflows and credentials data from the API.
- Supports skipping SSL verification for connections to instances with self-signed certificates.
- No additional external services or environment variables are needed.
Troubleshooting
Common issues:
- Incorrect or unreachable n8n Base URL will cause connection failures.
- If the n8n instance requires authentication for its REST API, this node will fail since it does not support auth.
- SSL errors may occur if connecting to an instance with a self-signed certificate and "Skip SSL Verification" is disabled.
Error messages:
"Failed to fetch credentials data: <error message>"indicates a problem connecting to or retrieving data from the n8n API. Check the base URL, network connectivity, and SSL settings."Invalid response format from n8n API"means the API did not return the expected workflows array. Verify the n8n instance version and API availability.
Resolutions:
- Ensure the base URL is correct and the n8n instance is running.
- Enable "Skip SSL Verification" if using self-signed certificates during development.
- Confirm the n8n API endpoint
/rest/workflowsis accessible without authentication.
Links and References
- n8n REST API Documentation
- n8n Workflows API Endpoint (for reference on
/rest/workflows)