Skip to main content

n8n Server

Overview​

The n8n server provides comprehensive integration with n8n automation platform, enabling AI assistants to manage workflows, monitor executions, and trigger automations programmatically.

Getting Started​

note

Using Civic with n8n workflows? If you're building n8n automations that need to access Civic, you'll need to generate a Civic access token. n8n requires tokens upfront because workflows run server-side without browser access. Learn how to generate and use Civic tokens.

  1. 1
    Connect to n8n

    Add the n8n server to your Civic environment through the server directory.

  2. 2
    Configure API Access

    Provide your n8n instance API URL and API key for authentication.

  3. 3
    Test Connection

    Start with a simple command like list workflows to verify the connection works properly.

What You Can Do​

Workflow Management

Create, update, activate, and delete n8n workflows programmatically

Execution Monitoring

Track workflow executions, view results, and monitor automation performance

Webhook Triggers

Execute workflows via webhook calls with custom input data and headers

Automation Control

Activate and deactivate workflows to control when automations run

Use Cases​

Workflow Automation
  • Dynamic Workflow Creation: Build workflows programmatically based on business requirements
  • Conditional Automation: Activate/deactivate workflows based on schedules or events
  • Bulk Operations: Manage multiple workflows simultaneously across projects
  • Integration Orchestration: Coordinate complex multi-step automations
Operations Monitoring
  • Execution Tracking: Monitor workflow success rates and performance metrics
  • Error Analysis: Identify and analyze failed executions for troubleshooting
  • Performance Optimization: Track execution duration and optimize slow workflows
  • Audit Trail: Maintain logs of workflow changes and execution history
Event-Driven Automation
  • Webhook Integration: Trigger workflows from external systems via webhooks
  • Data Processing: Process incoming data through automated workflow pipelines
  • Notification Systems: Set up automated alerts and notification workflows
  • API Orchestration: Chain multiple API calls through workflow automation

Available Tools (11)​

Workflow Management (6 tools)

Complete lifecycle management of n8n workflows from creation to deletion.

Core Workflow Operations

list_workflows

Retrieve a list of all workflows with optional filtering by active/inactive status

get_workflow

Retrieve detailed information about a specific workflow by ID

create_workflow

Create new workflows with nodes, connections, and configuration settings

update_workflow

Modify existing workflows including nodes, connections, and metadata

delete_workflow

Remove workflows permanently from the n8n instance

Workflow State Management

activate_workflow

Enable workflows to run automatically based on their trigger conditions

deactivate_workflow

Disable workflows to prevent automatic execution while preserving configuration

Execution Management (3 tools)

Monitor and manage workflow execution history and results.

list_executions

Retrieve workflow executions with filtering by workflow, status, and pagination support

get_execution

Get detailed execution information including node results and error data

delete_execution

Remove specific execution records from the execution history

info

Use status filters ('success', 'error', 'waiting', 'canceled') to find specific execution types quickly.

Webhook Integration (1 tool)

Execute workflows via HTTP webhooks with custom data and headers.

run_webhook

Trigger workflow execution via webhook with optional input data and custom headers

tip

Pro Tip: Use meaningful workflow names for webhook endpoints and include error handling in your workflows for robust webhook processing.

Resources​

The n8n server provides direct access to workflow and execution data through resource endpoints.

Collection Endpoints

Access entire data collections for browsing and discovery:

Workflows

n8n://workflows
Access the complete workflow directory

Execution Statistics

n8n://execution-stats
View execution metrics and performance data

Individual Record Endpoints

Access specific records when you know their ID:

Workflow Details

n8n://workflows/{id}
Get comprehensive workflow information including nodes and connections

Execution Details

n8n://executions/{id}
Get detailed execution results including node outputs and error information

tip

Pro Tip: Use collection endpoints to discover workflows and executions, then switch to individual record endpoints for detailed analysis.

Configuration Requirements​

Authentication Setup​

The n8n server requires API key authentication with your n8n instance:

Required Configuration
  • API Key: Your n8n instance API key (generated in n8n Settings → API Keys)
  • API URL: Your n8n instance API endpoint (e.g., https://n8n.example.com/api/v1)
  • Webhook Credentials (optional): Username/password for webhook authentication
Default Settings
  • Default API URL: https://n8n.civic.com/api/v1
  • Default Webhook Username: username
  • Default Webhook Password: password
warning

Ensure your n8n instance is accessible from the internet and API access is enabled in your n8n configuration.

note

The n8n server requires appropriate API permissions in your n8n instance to create, modify, and execute workflows.

Guardrails​

This server supports all 14 universal guardrails. Server-specific guardrails are coming soon.