N8N Node Configuration

Master n8n node configuration with operation-aware guidance and smart discovery

✨ The solution you've been looking for

Verified

Tested and verified by our team

16036 Stars

Operation-aware node configuration guidance. Use when configuring nodes, understanding property dependencies, determining required fields, choosing between get_node_essentials and get_node_info, or learning common configuration patterns by node type.

n8n workflow-automation node-configuration property-dependencies operation-aware system-admin automation validation

Repository

See It In Action

Interactive preview & real-world examples

Live Demo

AI Conversation Simulator

See how users interact with this skill

User Prompt

I need to configure an HTTP Request node to POST user data to https://api.example.com/users with JSON authentication. What are the required fields?

Skill Processing

Analyzing request...

Agent Response

Step-by-step configuration guidance starting with get_node_essentials, then progressive field addition based on validation feedback

Quick Start (3 Steps)

Get up and running in minutes

Install

claude-code skill install n8n-node-configuration

claude-code skill install n8n-node-configuration

Config

First Trigger

@n8n-node-configuration help

Commands

Command	Description	Required Args
@n8n-node-configuration configure-http-request-node-for-api-integration	Set up an HTTP request node to POST JSON data to an API endpoint with proper authentication	None
@n8n-node-configuration debug-missing-required-fields	Understand why validation fails due to conditional field requirements	None
@n8n-node-configuration switch-between-node-operations	Reconfigure a node when changing from one operation to another	None

Typical Use Cases

Configure HTTP Request Node for API Integration

Set up an HTTP request node to POST JSON data to an API endpoint with proper authentication

Debug Missing Required Fields

Understand why validation fails due to conditional field requirements

Switch Between Node Operations

Reconfigure a node when changing from one operation to another

Overview

n8n Node Configuration

Expert guidance for operation-aware node configuration with property dependencies.

Configuration Philosophy

Progressive disclosure: Start minimal, add complexity as needed

Configuration best practices:

get_node_essentials is the most used discovery pattern
56 seconds average between configuration edits
91.7% success rate with essentials-based configuration

Key insight: Most configurations need only essentials, not full schema!

Core Concepts

1. Operation-Aware Configuration

Not all fields are always required - it depends on operation!

Example: Slack node

 1// For operation='post'
 2{
 3  "resource": "message",
 4  "operation": "post",
 5  "channel": "#general",  // Required for post
 6  "text": "Hello!"        // Required for post
 7}
 8
 9// For operation='update'
10{
11  "resource": "message",
12  "operation": "update",
13  "messageId": "123",     // Required for update (different!)
14  "text": "Updated!"      // Required for update
15  // channel NOT required for update
16}

Key: Resource + operation determine which fields are required!

2. Property Dependencies

Fields appear/disappear based on other field values

Example: HTTP Request node

 1// When method='GET'
 2{
 3  "method": "GET",
 4  "url": "https://api.example.com"
 5  // sendBody not shown (GET doesn't have body)
 6}
 7
 8// When method='POST'
 9{
10  "method": "POST",
11  "url": "https://api.example.com",
12  "sendBody": true,       // Now visible!
13  "body": {               // Required when sendBody=true
14    "contentType": "json",
15    "content": {...}
16  }
17}

Mechanism: displayOptions control field visibility

3. Progressive Discovery

Use the right tool for the right job:

get_node_essentials (91.7% success rate)
- Quick overview
- Required fields
- Common options
- Use first - covers 90% of needs
get_property_dependencies (for complex nodes)
- Shows what fields depend on others
- Reveals conditional requirements
- Use when essentials isn’t enough
get_node_info (full schema)
- Complete documentation
- All possible fields
- Use when essentials + dependencies insufficient

Configuration Workflow

Standard Process

1. Identify node type and operation
   ↓
2. Use get_node_essentials
   ↓
3. Configure required fields
   ↓
4. Validate configuration
   ↓
5. If dependencies unclear → get_property_dependencies
   ↓
6. Add optional fields as needed
   ↓
7. Validate again
   ↓
8. Deploy

Example: Configuring HTTP Request

Step 1: Identify what you need

1// Goal: POST JSON to API

Step 2: Get essentials

1const info = get_node_essentials({
2  nodeType: "nodes-base.httpRequest"
3});
4
5// Returns: method, url, sendBody, body, authentication required/optional

Step 3: Minimal config

1{
2  "method": "POST",
3  "url": "https://api.example.com/create",
4  "authentication": "none"
5}

Step 4: Validate

1validate_node_operation({
2  nodeType: "nodes-base.httpRequest",
3  config,
4  profile: "runtime"
5});
6// → Error: "sendBody required for POST"

Step 5: Add required field

1{
2  "method": "POST",
3  "url": "https://api.example.com/create",
4  "authentication": "none",
5  "sendBody": true
6}

Step 6: Validate again

1validate_node_operation({...});
2// → Error: "body required when sendBody=true"

Step 7: Complete configuration

 1{
 2  "method": "POST",
 3  "url": "https://api.example.com/create",
 4  "authentication": "none",
 5  "sendBody": true,
 6  "body": {
 7    "contentType": "json",
 8    "content": {
 9      "name": "={{$json.name}}",
10      "email": "={{$json.email}}"
11    }
12  }
13}

Step 8: Final validation

1validate_node_operation({...});
2// → Valid! ✅

get_node_essentials vs get_node_info

Use get_node_essentials When:

✅ Starting configuration (91.7% success rate)

1get_node_essentials({
2  nodeType: "nodes-base.slack"
3});

Returns:

Required fields
Common options
Basic examples
Operation list

Fast: ~18 seconds average (from search → essentials)

Use get_node_info When:

✅ Essentials insufficient

1get_node_info({
2  nodeType: "nodes-base.slack"
3});

Returns:

Full schema
All properties
Complete documentation
Advanced options

Slower: More data to process

Decision Tree

┌─────────────────────────────────┐
│ Starting new node config?       │
├─────────────────────────────────┤
│ YES → get_node_essentials       │
└─────────────────────────────────┘
         ↓
┌─────────────────────────────────┐
│ Essentials has what you need?   │
├─────────────────────────────────┤
│ YES → Configure with essentials │
│ NO  → Continue                  │
└─────────────────────────────────┘
         ↓
┌─────────────────────────────────┐
│ Need dependency info?           │
├─────────────────────────────────┤
│ YES → get_property_dependencies │
│ NO  → Continue                  │
└─────────────────────────────────┘
         ↓
┌─────────────────────────────────┐
│ Still need more details?        │
├─────────────────────────────────┤
│ YES → get_node_info             │
└─────────────────────────────────┘

Property Dependencies Deep Dive

displayOptions Mechanism

Fields have visibility rules:

1{
2  "name": "body",
3  "displayOptions": {
4    "show": {
5      "sendBody": [true],
6      "method": ["POST", "PUT", "PATCH"]
7    }
8  }
9}

Translation: “body” field shows when:

sendBody = true AND
method = POST, PUT, or PATCH

Common Dependency Patterns

Pattern 1: Boolean Toggle

Example: HTTP Request sendBody

1// sendBody controls body visibility
2{
3  "sendBody": true   // → body field appears
4}

Pattern 2: Operation Switch

Example: Slack resource/operation

 1// Different operations → different fields
 2{
 3  "resource": "message",
 4  "operation": "post"
 5  // → Shows: channel, text, attachments, etc.
 6}
 7
 8{
 9  "resource": "message",
10  "operation": "update"
11  // → Shows: messageId, text (different fields!)
12}

Pattern 3: Type Selection

Example: IF node conditions

 1{
 2  "type": "string",
 3  "operation": "contains"
 4  // → Shows: value1, value2
 5}
 6
 7{
 8  "type": "boolean",
 9  "operation": "equals"
10  // → Shows: value1, value2, different operators
11}

Using get_property_dependencies

Example:

 1const deps = get_property_dependencies({
 2  nodeType: "nodes-base.httpRequest"
 3});
 4
 5// Returns dependency tree
 6{
 7  "dependencies": {
 8    "body": {
 9      "shows_when": {
10        "sendBody": [true],
11        "method": ["POST", "PUT", "PATCH", "DELETE"]
12      }
13    },
14    "queryParameters": {
15      "shows_when": {
16        "sendQuery": [true]
17      }
18    }
19  }
20}

Use this when: Validation fails and you don’t understand why field is missing/required

Common Node Patterns

Pattern 1: Resource/Operation Nodes

Examples: Slack, Google Sheets, Airtable

Structure:

1{
2  "resource": "<entity>",      // What type of thing
3  "operation": "<action>",     // What to do with it
4  // ... operation-specific fields
5}

How to configure:

Choose resource
Choose operation
Use get_node_essentials to see operation-specific requirements
Configure required fields

Pattern 2: HTTP-Based Nodes

Examples: HTTP Request, Webhook

Structure:

1{
2  "method": "<HTTP_METHOD>",
3  "url": "<endpoint>",
4  "authentication": "<type>",
5  // ... method-specific fields
6}

Dependencies:

POST/PUT/PATCH → sendBody available
sendBody=true → body required
authentication != “none” → credentials required

Pattern 3: Database Nodes

Examples: Postgres, MySQL, MongoDB

Structure:

1{
2  "operation": "<query|insert|update|delete>",
3  // ... operation-specific fields
4}

Dependencies:

operation=“executeQuery” → query required
operation=“insert” → table + values required
operation=“update” → table + values + where required

Pattern 4: Conditional Logic Nodes

Examples: IF, Switch, Merge

Structure:

 1{
 2  "conditions": {
 3    "<type>": [
 4      {
 5        "operation": "<operator>",
 6        "value1": "...",
 7        "value2": "..."  // Only for binary operators
 8      }
 9    ]
10  }
11}

Dependencies:

Binary operators (equals, contains, etc.) → value1 + value2
Unary operators (isEmpty, isNotEmpty) → value1 only + singleValue: true

Operation-Specific Configuration

Slack Node Examples

Post Message

1{
2  "resource": "message",
3  "operation": "post",
4  "channel": "#general",      // Required
5  "text": "Hello!",           // Required
6  "attachments": [],          // Optional
7  "blocks": []                // Optional
8}

Update Message

1{
2  "resource": "message",
3  "operation": "update",
4  "messageId": "1234567890",  // Required (different from post!)
5  "text": "Updated!",         // Required
6  "channel": "#general"       // Optional (can be inferred)
7}

Create Channel

1{
2  "resource": "channel",
3  "operation": "create",
4  "name": "new-channel",      // Required
5  "isPrivate": false          // Optional
6  // Note: text NOT required for this operation
7}

HTTP Request Node Examples

GET Request

 1{
 2  "method": "GET",
 3  "url": "https://api.example.com/users",
 4  "authentication": "predefinedCredentialType",
 5  "nodeCredentialType": "httpHeaderAuth",
 6  "sendQuery": true,                    // Optional
 7  "queryParameters": {                  // Shows when sendQuery=true
 8    "parameters": [
 9      {
10        "name": "limit",
11        "value": "100"
12      }
13    ]
14  }
15}

POST with JSON

 1{
 2  "method": "POST",
 3  "url": "https://api.example.com/users",
 4  "authentication": "none",
 5  "sendBody": true,                     // Required for POST
 6  "body": {                             // Required when sendBody=true
 7    "contentType": "json",
 8    "content": {
 9      "name": "John Doe",
10      "email": "john@example.com"
11    }
12  }
13}

IF Node Examples

String Comparison (Binary)

 1{
 2  "conditions": {
 3    "string": [
 4      {
 5        "value1": "={{$json.status}}",
 6        "operation": "equals",
 7        "value2": "active"              // Binary: needs value2
 8      }
 9    ]
10  }
11}

Empty Check (Unary)

 1{
 2  "conditions": {
 3    "string": [
 4      {
 5        "value1": "={{$json.email}}",
 6        "operation": "isEmpty",
 7        // No value2 - unary operator
 8        "singleValue": true             // Auto-added by sanitization
 9      }
10    ]
11  }
12}

Handling Conditional Requirements

Example: HTTP Request Body

Scenario: body field required, but only sometimes

Rule:

body is required when:
  - sendBody = true AND
  - method IN (POST, PUT, PATCH, DELETE)

How to discover:

 1// Option 1: Read validation error
 2validate_node_operation({...});
 3// Error: "body required when sendBody=true"
 4
 5// Option 2: Check dependencies
 6get_property_dependencies({
 7  nodeType: "nodes-base.httpRequest"
 8});
 9// Shows: body → shows_when: sendBody=[true], method=[POST,PUT,PATCH,DELETE]
10
11// Option 3: Try minimal config and iterate
12// Start without body, validation will tell you if needed

Example: IF Node singleValue

Scenario: singleValue property appears for unary operators

Rule:

singleValue should be true when:
  - operation IN (isEmpty, isNotEmpty, true, false)

Good news: Auto-sanitization fixes this!

Manual check:

1get_property_dependencies({
2  nodeType: "nodes-base.if"
3});
4// Shows operator-specific dependencies

Configuration Anti-Patterns

❌ Don’t: Over-configure Upfront

Bad:

 1// Adding every possible field
 2{
 3  "method": "GET",
 4  "url": "...",
 5  "sendQuery": false,
 6  "sendHeaders": false,
 7  "sendBody": false,
 8  "timeout": 10000,
 9  "ignoreResponseCode": false,
10  // ... 20 more optional fields
11}

Good:

1// Start minimal
2{
3  "method": "GET",
4  "url": "...",
5  "authentication": "none"
6}
7// Add fields only when needed

❌ Don’t: Skip Validation

Bad:

1// Configure and deploy without validating
2const config = {...};
3n8n_update_partial_workflow({...});  // YOLO

Good:

1// Validate before deploying
2const config = {...};
3const result = validate_node_operation({...});
4if (result.valid) {
5  n8n_update_partial_workflow({...});
6}

❌ Don’t: Ignore Operation Context

Bad:

 1// Same config for all Slack operations
 2{
 3  "resource": "message",
 4  "operation": "post",
 5  "channel": "#general",
 6  "text": "..."
 7}
 8
 9// Then switching operation without updating config
10{
11  "resource": "message",
12  "operation": "update",  // Changed
13  "channel": "#general",  // Wrong field for update!
14  "text": "..."
15}

Good:

1// Check requirements when changing operation
2get_node_essentials({
3  nodeType: "nodes-base.slack"
4});
5// See what update operation needs (messageId, not channel)

Best Practices

✅ Do

Start with get_node_essentials
- 91.7% success rate
- Faster than get_node_info
- Sufficient for most needs
Validate iteratively
- Configure → Validate → Fix → Repeat
- Average 2-3 iterations is normal
- Read validation errors carefully
Use property dependencies when stuck
- If field seems missing, check dependencies
- Understand what controls field visibility
- get_property_dependencies reveals rules
Respect operation context
- Different operations = different requirements
- Always check essentials when changing operation
- Don’t assume configs are transferable
Trust auto-sanitization
- Operator structure fixed automatically
- Don’t manually add/remove singleValue
- IF/Switch metadata added on save

❌ Don’t

Jump to get_node_info immediately
- Try essentials first
- Only escalate if needed
- Full schema is overwhelming
Configure blindly
- Always validate before deploying
- Understand why fields are required
- Check dependencies for conditional fields
Copy configs without understanding
- Different operations need different fields
- Validate after copying
- Adjust for new context
Manually fix auto-sanitization issues
- Let auto-sanitization handle operator structure
- Focus on business logic
- Save and let system fix structure

Detailed References

For comprehensive guides on specific topics:

DEPENDENCIES.md - Deep dive into property dependencies and displayOptions
OPERATION_PATTERNS.md - Common configuration patterns by node type

Summary

Configuration Strategy:

Start with get_node_essentials (91.7% success)
Configure required fields for operation
Validate configuration
Check dependencies if stuck
Iterate until valid (avg 2-3 cycles)
Deploy with confidence

Key Principles:

Operation-aware: Different operations = different requirements
Progressive disclosure: Start minimal, add as needed
Dependency-aware: Understand field visibility rules
Validation-driven: Let validation guide configuration

Related Skills:

n8n MCP Tools Expert - How to use discovery tools correctly
n8n Validation Expert - Interpret validation errors
n8n Expression Syntax - Configure expression fields
n8n Workflow Patterns - Apply patterns with proper configuration

What Users Are Saying

Real feedback from the community

Environment Matrix

Dependencies

n8n workflow automation platform

Framework Support

n8n ✓ (recommended)

Context Window

Token Usage ~3K-8K tokens for complex node configurations with dependencies

Security & Privacy

Information

Author: davila7
Updated: 2026-01-30
Category: system-admin

N8N Node Configuration

See It In Action

AI Conversation Simulator

Quick Start (3 Steps)

Install

Config

First Trigger

Commands

Typical Use Cases

Configure HTTP Request Node for API Integration

Debug Missing Required Fields

Switch Between Node Operations

Overview

n8n Node Configuration

Configuration Philosophy

Core Concepts

1. Operation-Aware Configuration

2. Property Dependencies

3. Progressive Discovery

Configuration Workflow

Standard Process

Example: Configuring HTTP Request

get_node_essentials vs get_node_info

Use get_node_essentials When:

Use get_node_info When:

Decision Tree

Property Dependencies Deep Dive

displayOptions Mechanism

Common Dependency Patterns

Pattern 1: Boolean Toggle

Pattern 2: Operation Switch

Pattern 3: Type Selection

Using get_property_dependencies

Common Node Patterns

Pattern 1: Resource/Operation Nodes

Pattern 2: HTTP-Based Nodes

Pattern 3: Database Nodes

Pattern 4: Conditional Logic Nodes

Operation-Specific Configuration

Slack Node Examples

Post Message

Update Message

Create Channel

HTTP Request Node Examples

GET Request

POST with JSON

IF Node Examples

String Comparison (Binary)

Empty Check (Unary)

Handling Conditional Requirements

Example: HTTP Request Body

Example: IF Node singleValue

Configuration Anti-Patterns

❌ Don’t: Over-configure Upfront

❌ Don’t: Skip Validation

❌ Don’t: Ignore Operation Context

Best Practices

✅ Do

❌ Don’t

Detailed References

Summary

What Users Are Saying

Environment Matrix

Dependencies

Framework Support

Context Window

Security & Privacy

Information

Related Skills

N8N Node Configuration

N8N Code Javascript

N8N Code Javascript