n8n-nodes-neo

This is an n8n Community Node for integrating the docunite® NEO API by docunite.com.

docunite® NEO is an intelligent document management platform with AI-powered classification, extraction, and processing. This node allows you to use all docunite® NEO API features directly in your n8n workflows.

n8n is a fair-code licensed workflow automation tool.

🚀 Installation

For n8n Cloud Users

Note: This community node will be available in n8n Cloud after it has been verified by n8n. We have submitted it for verification and will update this section once approved.

Once verified, you will be able to install it directly from the n8n node panel.

For Self-hosted n8n Instances

You can install this node manually on your self-hosted n8n instance (requires n8n v0.187+):

Option 1: Using Community Nodes Feature

1. Go to Settings > Community Nodes
2. Select Install
3. Enter n8n-nodes-neo in the "Enter npm package name" field
4. Agree to the risks of using Community Nodes
5. Install the node

After installation, the docunite® NEO node will be available in your n8n instance.

Option 2: Manual Installation

For self-hosted n8n instances, you can also install the node manually:

cd ~/.n8n/nodes
npm install n8n-nodes-neo

Restart n8n for the changes to take effect.

🔑 Credentials

To use the docunite® NEO node, you need:

1. API Key: Your docunite® NEO API Key
2. Base URL: Defaults to https://api.docunite.ai

Setting up Credentials

1. Go to Credentials > New
2. Search for "docunite® NEO API"
3. Enter your API Key
4. Save the credentials

📚 Nodes

This package provides two nodes:

1. docunite® NEO (Regular Node)

The main node for API operations.

2. docunite® NEO Trigger (Trigger Node)

Automatically starts workflows when docunite® NEO sends events.

📚 Operations

The docunite® NEO node supports the following resources and operations:

📊 Account Management

• Get Balance: Retrieve credit balance
• Get Usage: Retrieve usage statistics (daily, monthly, yearly)
• Get Usage With Process Steps: Detailed usage information with process step breakdown

📄 Document Management

• Upload: Upload and process documents
  • Supports automatic classification
  • Intelligent document splitting
  • Custom prompts
  • Optional original path storage
• Get: Retrieve document by ID
• Get Batch: Retrieve documents by correlation ID (e.g., extracted attachments)
• Get Document PDF Blob: Get a PDF version of the document
• Get Document Original Blob: Get the original version of the document
• Get Document OCR: Get document OCR content
• Get Document Markdown: Get document markdown content
• Delete: Delete single document
• Chat: Chat with a document using AI
  • Supports custom prompts
  • Optional chat history
• Classify: Classify documents
  • Custom prompt support
  • Batch processing with file IDs
• Enrichment: Initiate document enrichment
  • Batch processing with file IDs
• Extraction: Extract OCR from documents
  • Batch processing with file IDs
• Split: Split documents into multiple parts
  • Batch processing with file IDs

🏢 Entity Management

• Get All: Retrieve all entities
• Get: Retrieve entity by ID
• Create: Create new entity
• Update: Update entity
• Delete: Delete entity

🔔 Webhook Management

• Get All: Retrieve all webhooks
• Get: Retrieve webhook by ID
• Create: Create new webhook
• Update: Update webhook
• Delete: Delete webhook

💻 Usage Examples

Example 1: Upload and Classify a Document

{
  "nodes": [
    {
      "parameters": {
        "resource": "document",
        "operation": "upload",
        "entityId": "your-entity-id",
        "binaryPropertyName": "data",
        "classify": true,
        "splitDocuments": false
      },
      "name": "docunite® NEO - Upload Document",
      "type": "n8n-nodes-neo.neo",
      "credentials": {
        "neoApi": "docunite® NEO API Credentials"
      }
    }
  ]
}

Example 2: Chat with a Document

{
  "nodes": [
    {
      "parameters": {
        "resource": "document",
        "operation": "chat",
        "documentId": "document-id-here",
        "prompt": "What are the key points in this document?"
      },
      "name": "docunite® NEO - Chat with Document",
      "type": "n8n-nodes-neo.neo",
      "credentials": {
        "neoApi": "docunite® NEO API Credentials"
      }
    }
  ]
}

Example 3: Classify Multiple Documents

{
  "nodes": [
    {
      "parameters": {
        "resource": "document",
        "operation": "classify",
        "fileIds": "[\"file-id-1\", \"file-id-2\"]",
        "promptId": "your-classification-prompt-id"
      },
      "name": "docunite® NEO - Classify Documents",
      "type": "n8n-nodes-neo.neo",
      "credentials": {
        "neoApi": "docunite® NEO API Credentials"
      }
    }
  ]
}

Example 4: Manage Entities

{
  "nodes": [
    {
      "parameters": {
        "resource": "entity",
        "operation": "create",
        "entityName": "My Project"
      },
      "name": "docunite® NEO - Create Entity",
      "type": "n8n-nodes-neo.neo",
      "credentials": {
        "neoApi": "docunite® NEO API Credentials"
      }
    }
  ]
}

Example 5: Extract OCR from Documents

{
  "nodes": [
    {
      "parameters": {
        "resource": "document",
        "operation": "extraction",
        "fileIds": "[\"file-id-1\", \"file-id-2\"]"
      },
      "name": "docunite® NEO - Extract OCR",
      "type": "n8n-nodes-neo.neo",
      "credentials": {
        "neoApi": "docunite® NEO API Credentials"
      }
    }
  ]
}

🔔 docunite® NEO Trigger Node

The docunite® NEO Trigger node automatically starts your workflow when NEO sends events.

Features

• ✅ Automatic webhook registration when activating workflow
• ✅ Automatic webhook removal when deactivating workflow
• ✅ Event type filtering (EXTRACTION, CLASSIFICATION, ENRICHMENT)
• ✅ Secret validation via x-neo-secret header
• ✅ Test mode support with "Listen for Test Event"
• ✅ No generic webhook setup required

Configuration

1. Add the docunite® NEO Trigger node to your workflow
2. Configure credentials (docunite® NEO API)
3. Select event types to listen for
4. Set a webhook name
5. Choose a secret for authentication
6. Activate the workflow → Webhook is automatically registered in NEO

Test Mode

Click "Listen for Test Event" to get a test webhook URL. You must manually register this URL in NEO for testing. Secret validation is automatically disabled in test mode.

Production Mode

When you activate the workflow, the webhook is automatically registered in NEO with the production URL. The webhook is removed when you deactivate the workflow.

📖 API Documentation

The complete API documentation can be found at:

• Swagger UI: https://api.docunite.ai/
• Swagger JSON: https://api.docunite.ai/swagger.json

🛠️ Compatibility

• Tested with n8n v0.187.0+
• Node.js 18.17.0+
• n8n-workflow 1.0.0+

📝 License

MIT

🤝 Support

For questions or issues:

• GitHub Issues: https://github.com/docunite/neo-n8n-node/issues
• docunite Support: [email protected]

🔗 Resources

• n8n Community Nodes Documentation
• docunite.com Website
• docunite® NEO API Documentation

🌟 Features

• ✅ Full docunite® NEO API integration for core resources
• ✅ NEO Trigger Node - Automatic workflow starts on NEO events
• ✅ Account Management (Balance & Usage tracking)
• ✅ Document Management (Upload, Processing, Chat, OCR, etc.)
• ✅ Entity Management (Full CRUD operations)
• ✅ Webhook Management (Full CRUD operations)
• ✅ API Key authentication
• ✅ Comprehensive error handling
• ✅ Binary Data support (Upload/Download)
• ✅ AI-powered document processing and chat
• ✅ Batch operations support
• ✅ Automatic webhook registration and cleanup

📦 Version History

0.1.0 (Initial Release)

• Full integration of core docunite® NEO API endpoints
• Account Management (Balance, Usage, Usage with Process Steps)
• Document Management (Upload, Get, Chat, Classify, Enrichment, Extraction, Split, etc.)
• Entity Management (CRUD operations)
• Webhook Management (CRUD operations)

👨‍💻 Development

If you want to contribute to development:

# Clone repository
git clone https://github.com/docunite/neo-n8n-node.git
cd neo-n8n-node

# Install dependencies
npm install

# Build
npm run build

# Link to local n8n instance
npm link

Start n8n in development mode:

n8n start

⚠️ Important Notes

• File uploads use Binary Data from n8n workflows
• Chat operations support streaming responses
• All JSON parameters can be set dynamically via n8n expressions
• Document processing operations support batch processing with file IDs

Developed with ❤️ for the n8n community by docunite GmbH