n8n-nodes-humanfirst

This is an n8n community node that enables integration with the HumanFirst platform.

HumanFirst is a powerful AI studio for power users and teams, designed to help you build reliable, context-rich, reusable AI workflows and automations.

n8n is a fair-code licensed workflow automation platform.

About HumanFirst

HumanFirst is a unified AI development and operations platform designed for people and teams who want to do more with AI. It helps you:

• Chat with your data via a conversational interface
• Template your prompts using explicit context control
• Run AI at scale with parallel prompt execution
• Manage context, prompts, data, and results in a single managed library

What Makes HumanFirst Unique

1. Prompt Building Studio
   Create prompts as if you’re delegating tasks to a real team member. Inject structured context, eliminate black-box prompts, and ensure precision without in-chat adjustments.

2. Prototyping Playground
   Test and iterate on prompts in real-time with both conversational and dataset-based feedback. Codify what works directly into your instructions.

3. Managed Library
   Keep your prompts, inputs, contexts, and results centralized, version-controlled, and reusable across teams and projects.

Built for Scale and Security

• SOC 2 Type II compliant
• Supports SSO & SAML
• Offers optional on-premise deployment
• Integrates with platforms like Zapier, Make, and n8n
• Compatible with major LLM providers: OpenAI, Anthropic, Cohere, Gemini, Mistral, and more

Learn more at humanfirst.ai.

Installation
Operations
Credentials
Compatibility
Usage
Resources
Version history

Installation

Follow the installation guide in the n8n community nodes documentation.

Operations

This node supports the following HumanFirst API operations:

Operation	Description
getPlaybookInfo	Fetch metadata for a specific playbook
listPlaybooks	List all playbooks within a namespace
importCsvFile	Import a CSV into a conversation set
convertJsonToCsv	Convert JSON to CSV format (supports flattening and array field targeting)
addColumnToCsv	Add a constant column to an existing binary CSV
runPipelineWorkflow	Trigger a full pipeline, wait for it to complete, and export the results
importDocument	Upload a document to a Conversation Source and trigger indexing

Credentials

This node uses HumanFirst's API for authentication. You'll need to configure the following credentials:

Field	Description
API Key	Your HumanFirst API Key (get it by following the steps here)
Base URL	HumanFirst API base URL (default: https://api.humanfirst.ai)
API Version	API version (default: v1alpha1)
Namespace for Test	A namespace used to validate credentials (must already exist)

These fields are entered when creating the HumanFirst API credentials in your n8n instance.

Compatibility

Tested against following N8N and Node.js versions.

• N8N version: 1.92.2
• Node.js version: 20.19.0

Usage

1. Configure Credentials
   Go to your n8n credentials manager and set up the HumanFirst API credentials using your API key and namespace.

2. Add Node to Workflow
   Insert the HumanFirst node into your workflow and choose an operation such as "List Playbooks" or "Import CSV".

3. Set Parameters
   Fill in the required parameters for the selected operation.

4. Run and Automate
   Execute the node and begin automating your AI workflows using HumanFirst's platform capabilities.

Resources

• HumanFirst Website
• API Documentation
• n8n Community Nodes Docs

Version History

Version	Changes
1.0.0	Initial release with playbook listing, document import, CSV handling, and pipeline workflow support