n8n API Hub Node

A custom n8n node that enables seamless integration with API Hub, allowing you to access and manage APIs directly within your n8n workflows.

Overview

The API Hub node provides a unified interface to call various APIs through an API key-based authentication system. It handles authentication, request formatting, and response processing, making it easy to integrate third-party APIs into your n8n automation workflows.

Features

• 🔐 Secure API key authentication
• 🌐 Support for all HTTP methods (GET, POST, PUT, DELETE, PATCH)
• 📝 Custom headers and query parameters
• 🔄 JSON request body support
• 📊 Automatic response parsing
• 🛡️ Error handling with optional continue-on-fail
• 📋 Array response handling (each item becomes a separate row)

Installation

Prerequisites

• n8n installed globally or locally
• Node.js (version 16 or higher)
• An API key for the APIs you want to access

Setup

1. Clone or download this repository to your local machine:

   git clone <repository-url>
   cd n8n-nodes-apihub
   

2. Install n8n globally if you haven't already:

   npm install n8n -g
   

3. Run n8n with the custom node:

   N8N_CUSTOM_EXTENSIONS=$(pwd) n8n start
   

4. Access n8n at http://localhost:5678

Configuration

Credentials Setup

Before using the API Hub node, you need to configure your credentials:

1. In n8n, go to Settings → Credentials
2. Click Create New Credential
3. Select API Hub API from the list
4. Fill in the required fields:
   • Base URL: Your API base URL
   • API Key: Your API key

Node Configuration

The API Hub node supports the following parameters:

Parameter	Type	Required	Description
API ID	String	Yes	The unique identifier of the API you want to call
HTTP Method	Options	Yes	The HTTP method (GET, POST, PUT, DELETE, PATCH)
Endpoint Path	String	No	The specific endpoint path to call
Request Body	JSON	No	JSON request body (for POST, PUT, PATCH methods)
Query Parameters	Collection	No	URL query parameters as key-value pairs
Custom Headers	Collection	No	Custom HTTP headers as key-value pairs

Authentication

The node uses Bearer token authentication:

• API Access: Your API key is automatically added to requests in the Authorization header as a Bearer token (Authorization: Bearer your-api-key)

Response Handling

Single Object Response

When the API returns a single object, it's passed through as-is to the next node.

Array Response

When the API returns an array, each item in the array becomes a separate output item, allowing for easy processing in subsequent nodes.

Error Handling

• Failed requests throw errors by default
• Enable "Continue on Fail" to capture errors as output data
• Error outputs include the error message and timestamp

Troubleshooting

Common Issues

1. Authentication Failed

   • Verify your API key is correct
   • Check that the base URL is configured properly
   • Ensure your API key has the necessary permissions

2. API Not Found

   • Verify the API ID is correct
   • Check that the endpoint path is valid

3. Request Failed

   • Check the endpoint path is correct
   • Verify required parameters are provided
   • Review the API documentation for specific requirements

Debug Tips

• Enable "Continue on Fail" to capture error details
• Use the n8n execution logs to see full request/response data
• Test API calls directly using tools like Postman first

Development

Local Development Setup

1. Install dependencies:

   npm install
   

2. Start n8n in development mode:

   N8N_CUSTOM_EXTENSIONS=$(pwd) n8n start
   

File Structure

n8n-nodes-apihub/
├── nodes/
│   └── APIHub/
│       ├── APIHub.node.js          # Main node implementation
│       └── APIHubApi.credentials.js # Credentials definition
├── package.json                    # Node package configuration
├── README.md                       # This documentation
├── DEVELOPMENT.md                  # Development setup guide
└── LICENSE                         # License file

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

Support

• n8n Community: n8n Community Forum
• Issues: Report issues in this repository

License

This project is licensed under the MIT License - see the LICENSE file for details.

Changelog

Version 1.0.0

• Initial release
• Support for all HTTP methods
• Custom headers and query parameters
• JSON request body support
• Array response handling
• Error handling with continue-on-fail option