Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Expression Reference Error

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "id": "55",
  "name": "CFP Selection 2",
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        400,
        250
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "14725eac-0be5-4b30-a9dd-cce0b921c37b",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "Airtable",
      "type": "n8n-nodes-base.airtable",
      "position": [
        600,
        250
      ],
      "parameters": {
        "table": "",
        "operation": "list",
        "application": "",
        "additionalOptions": {
          "filterByFormula": "{Total Score} > 15"
        }
      },
      "credentials": {
        "airtableApi": "Airtable"
      },
      "typeVersion": 1,
      "id": "9613dbca-8f8c-422f-9176-38d93ad57ce0",
      "notes": "This airtable node performs automated tasks as part of the workflow."
    },
    {
      "name": "Bannerbear",
      "type": "n8n-nodes-base.bannerbear",
      "position": [
        800,
        250
      ],
      "parameters": {
        "templateId": "",
        "modificationsUi": {
          "modificationsValues": [
            {
              "name": "talk title",
              "text": "={{$node[\"Airtable\"].json[\"fields\"][\"What's the title of your talk?\"]}}"
            },
            {
              "name": "abstract",
              "text": "={{$node[\"Airtable\"].json[\"fields\"][\"Please share the abstract of your talk.\"]}}"
            },
            {
              "name": "profile image",
              "imageUrl": "{{ $env.BASE_URL }}"
            },
            {
              "name": "username",
              "text": "={{$node[\"Airtable\"].json[\"fields\"][\"Your twitter handle\"]}}"
            },
            {
              "name": "full name",
              "text": "={{$node[\"Airtable\"].json[\"fields\"][\"Great, can we get your full name?\"]}}"
            }
          ]
    ...

Output:
In node 'Trello', the parameter 'name' contains an expression that references undefined data.

**Faulty Expression**: `={{ $json["non_existent_field"] }}`
**Original Value**: `={{$node["Airtable"].json["fields"]["What's the title of your talk?"]}}`

**Root Cause**: The expression references a field, node, or variable that doesn't exist in the data flow.

**Debugging Steps**:
1. Check the output of previous nodes to verify available fields
2. Use the Expression Editor to test expressions interactively
3. Add a Set node before this one to inspect available data
4. Use optional chaining for potentially undefined fields: `$json.field?.subfield`

**Best Practice**: Always validate data availability before using expressions.

Fix the expression in 'Trello' parameter 'name'.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Data Type Mismatch

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        250,
        300
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "610afd4d-e031-4754-86a4-382e95250226",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "Microsoft OneDrive",
      "type": "n8n-nodes-base.microsoftOneDrive",
      "position": [
        450,
        300
      ],
      "parameters": {
        "name": "n8n-rocks",
        "options": {},
        "resource": "folder",
        "operation": "create",
        "_injected_number_field": "not_a_number"
      },
      "credentials": {
        "microsoftOneDriveOAuth2Api": "n8n-docs-creds"
      },
      "typeVersion": 1,
      "id": "ff73d3ca-2d4a-4082-a637-bbd004c8f77c",
      "notes": "This microsoftOneDrive node performs automated tasks as part of the workflow."
    },
    {
      "id": "error-5ed8da60",
      "name": "Error Handler",
      "type": "n8n-nodes-base.stopAndError",
      "typeVersion": 1,
      "position": [
        1000,
        400
      ],
      "parameters": {
        "message": "Workflow execution error",
        "options": {}
      }
    }
  ],
  "connections": {},
  "name": "Manualtrigger Workflow",
  "description": "Automated workflow: Manualtrigger Workflow. This workflow processes data and performs automated tasks.",
  "settings": {
    "executionOrder": "v1",
    "saveManualExecutions": true,
    "callerPolicy": "workflowsFromSameOwner",
    "errorWorkflow": null,
    "timezone": "UTC",
    "executionTimeout": 3600,
    "maxExecutions": 1000,
    "retryOnFail": true,
    "retryCount": 3,
    "retryDelay": 1000
  },
  "meta": {
    "instanceId": "workflow-8d62403b",
    "versionId": "1.0.0",
    "createdAt": "2025-09-29T07:07:49.543377",
    "updatedAt": "2025-09-29T07:07:49.543387",
    "owner": "n8n-user",
    "license": "MIT",
    "category": "automation",
    ...

Output:
The node 'Microsoft OneDrive' has a data type mismatch in its parameters.

**Issue**: A field expected a number but received a string value.

**Common Causes**:
1. Expression returns string instead of number
2. JSON parsing preserves string types for numeric values
3. Upstream node outputs different data types than expected

**Solutions**:

1. **Type Conversion in Expression**:
```javascript
// Convert string to number
{ parseInt($json.stringValue) }
{ parseFloat($json.decimalString) }
{ Number($json.value) }
```

2. **Use Code Node for Transformation**:
```javascript
return items.map(item => {
  item.json.numericField = Number(item.json.stringField);
  return item;
});
```

3. **Validate Data Types**:
- Use IF node to check types before processing
- Add error handling for invalid types

**Best Practice**: Always validate and transform data types explicitly when passing data between nodes.

Fix data type conversion in 'Microsoft OneDrive'.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Expression Reference Error

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        250,
        300
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "223e4844-402f-4185-9a08-e24ad621be22",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "Microsoft Excel",
      "type": "n8n-nodes-base.microsoftExcel",
      "position": [
        450,
        300
      ],
      "parameters": {
        "filters": {},
        "operation": "getAll"
      },
      "credentials": {
        "microsoftExcelOAuth2Api": "ms-oauth-creds"
      },
      "typeVersion": 1,
      "id": "ce9cf2ca-19c6-457f-b018-c72c66f6906e",
      "notes": "This microsoftExcel node performs automated tasks as part of the workflow."
    },
    {
      "id": "error-d5423dea",
      "name": "Error Handler",
      "type": "n8n-nodes-base.stopAndError",
      "typeVersion": 1,
      "position": [
        1000,
        400
      ],
      "parameters": {
        "message": "={{ $items[999].json.value }}",
        "options": {}
      }
    }
  ],
  "connections": {},
  "name": "Manualtrigger Workflow",
  "description": "Automated workflow: Manualtrigger Workflow. This workflow processes data and performs automated tasks.",
  "settings": {
    "executionOrder": "v1",
    "saveManualExecutions": true,
    "callerPolicy": "workflowsFromSameOwner",
    "errorWorkflow": null,
    "timezone": "UTC",
    "executionTimeout": 3600,
    "maxExecutions": 1000,
    "retryOnFail": true,
    "retryCount": 3,
    "retryDelay": 1000
  },
  "meta": {
    "instanceId": "workflow-59247322",
    "versionId": "1.0.0",
    "createdAt": "2025-09-29T07:07:49.546972",
    "updatedAt": "2025-09-29T07:07:49.546997",
    "owner": "n8n-user",
    "license": "MIT",
    "category": "automation",
    "status": "active",
    "priority": "high",
    "environment": "production"
  },
  "tags": [
    "automation",
    "...

Output:
In node 'Error Handler', the parameter 'message' contains an expression that references undefined data.

**Faulty Expression**: `={{ $items[999].json.value }}`
**Original Value**: `Workflow execution error`

**Root Cause**: The expression references a field, node, or variable that doesn't exist in the data flow.

**Debugging Steps**:
1. Check the output of previous nodes to verify available fields
2. Use the Expression Editor to test expressions interactively
3. Add a Set node before this one to inspect available data
4. Use optional chaining for potentially undefined fields: `$json.field?.subfield`

**Best Practice**: Always validate data availability before using expressions.

Fix the expression in 'Error Handler' parameter 'message'.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Missing Credentials

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        250,
        300
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "97720984-16c4-4728-b99e-a6248e44da02",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "HelpScout",
      "type": "n8n-nodes-base.helpScout",
      "position": [
        450,
        300
      ],
      "parameters": {
        "resource": "mailbox",
        "operation": "getAll"
      },
      "typeVersion": 1,
      "id": "ee254be5-964a-42c9-87bd-760219373768",
      "notes": "This helpScout node performs automated tasks as part of the workflow."
    },
    {
      "id": "error-0728fc76",
      "name": "Error Handler",
      "type": "n8n-nodes-base.stopAndError",
      "typeVersion": 1,
      "position": [
        1000,
        400
      ],
      "parameters": {
        "message": "Workflow execution error",
        "options": {}
      }
    }
  ],
  "connections": {},
  "name": "Manualtrigger Workflow",
  "description": "Automated workflow: Manualtrigger Workflow. This workflow processes data and performs automated tasks.",
  "settings": {
    "executionOrder": "v1",
    "saveManualExecutions": true,
    "callerPolicy": "workflowsFromSameOwner",
    "errorWorkflow": null,
    "timezone": "UTC",
    "executionTimeout": 3600,
    "maxExecutions": 1000,
    "retryOnFail": true,
    "retryCount": 3,
    "retryDelay": 1000
  },
  "meta": {
    "instanceId": "workflow-765b3e5f",
    "versionId": "1.0.0",
    "createdAt": "2025-09-29T07:07:49.563548",
    "updatedAt": "2025-09-29T07:07:49.563568",
    "owner": "n8n-user",
    "license": "MIT",
    "category": "automation",
    "status": "active",
    "priority": "high",
    "environment": "production"
  },
  "tags": [
    "automation",
    "n8n",
    "production-ready",
    "excellent",
    "optimized"
  ],
  "notes": "Excellent quality...

Output:
The node 'HelpScout' (type: n8n-nodes-base.helpScout) requires credentials but the 'credentials' configuration is missing.

**Root Cause**: The credentials object was not defined for this node.

**Solution**: Add the credentials configuration back to the node:
```json
"credentials": {
  "helpScoutOAuth2Api": "helpscout_creds"
}
```

**Best Practice**: Always verify credentials are properly configured before deploying workflows. Use n8n's credential management system to store sensitive data securely.

Add credentials configuration to the 'HelpScout' node.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Timeout Configuration

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        250,
        300
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "76e7b853-a935-4365-9331-f28520670a8f",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "Mandrill",
      "type": "n8n-nodes-base.mandrill",
      "position": [
        450,
        300
      ],
      "parameters": {
        "options": {},
        "toEmail": "user@example.com",
        "template": "welcomeemailv2",
        "fromEmail": "example@yourdomain.com"
      },
      "credentials": {
        "mandrillApi": "mandrill_creds"
      },
      "typeVersion": 1,
      "id": "a7b30dd7-0607-4762-a73d-e2d6f1b34e05",
      "notes": "This mandrill node performs automated tasks as part of the workflow."
    },
    {
      "id": "error-d77eb9aa",
      "name": "Error Handler",
      "type": "n8n-nodes-base.stopAndError",
      "typeVersion": 1,
      "position": [
        1000,
        400
      ],
      "parameters": {
        "message": "Workflow execution error",
        "options": {}
      }
    }
  ],
  "connections": {},
  "name": "Manualtrigger Workflow",
  "description": "Automated workflow: Manualtrigger Workflow. This workflow processes data and performs automated tasks.",
  "settings": {
    "executionOrder": "v1",
    "saveManualExecutions": true,
    "callerPolicy": "workflowsFromSameOwner",
    "errorWorkflow": null,
    "timezone": "UTC",
    "executionTimeout": 3600,
    "maxExecutions": 1000,
    "retryOnFail": true,
    "retryCount": 3,
    "retryDelay": 1000
  },
  "meta": {
    "instanceId": "workflow-6962fd74",
    "versionId": "1.0.0",
    "createdAt": "2025-09-29T07:07:49.562100",
    "updatedAt": "2025-09-29T07:07:49.562113",
    "owner": "n8n-user",
    "license": "MIT",
    "category": "automation",
    "status": "active",
    "priority": "high",
    "environmen...

Output:
This workflow may experience timeout issues with long-running API requests.

**Symptoms**:
- Execution hangs indefinitely
- Connection timeout errors
- ETIMEDOUT or ESOCKETTIMEDOUT errors

**Root Cause**: No timeout configured for HTTP requests, or external services are slow.

**Solutions**:

1. **Set Appropriate Timeouts**:
```json
"options": {
  "timeout": 30000  // 30 seconds
}
```

2. **Add Error Handling**:
- Use Error Trigger node to catch timeout errors
- Implement fallback logic for failed requests

3. **Use Async Patterns**:
- For long operations, use webhook callbacks
- Implement polling patterns instead of waiting

4. **Configure Node Settings**:
```json
"retryOnFail": true,
"maxTries": 3,
"waitBetweenTries": 2000,
"continueOnFail": true
```

**Best Practice**: Set reasonable timeouts (10-30 seconds) and always have error handling for external API calls.

Configure appropriate timeouts and error handling for HTTP requests.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Empty Input Handling

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        250,
        300
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "63639ed8-7a61-4ec4-9793-f79a70bcc413",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "Crypto",
      "type": "n8n-nodes-base.crypto",
      "position": [
        450,
        300
      ],
      "parameters": {
        "value": "n8n rocks!"
      },
      "typeVersion": 1,
      "id": "ea6c2fc1-80f9-4477-908f-f7f9029346e7",
      "notes": "This crypto node performs automated tasks as part of the workflow."
    },
    {
      "id": "error-064d3879",
      "name": "Error Handler",
      "type": "n8n-nodes-base.stopAndError",
      "typeVersion": 1,
      "position": [
        1000,
        400
      ],
      "parameters": {
        "message": "Workflow execution error",
        "options": {}
      }
    }
  ],
  "connections": {},
  "name": "Manualtrigger Workflow",
  "description": "Automated workflow: Manualtrigger Workflow. This workflow processes data and performs automated tasks.",
  "settings": {
    "executionOrder": "v1",
    "saveManualExecutions": true,
    "callerPolicy": "workflowsFromSameOwner",
    "errorWorkflow": null,
    "timezone": "UTC",
    "executionTimeout": 3600,
    "maxExecutions": 1000,
    "retryOnFail": true,
    "retryCount": 3,
    "retryDelay": 1000
  },
  "meta": {
    "instanceId": "workflow-4c93dc1a",
    "versionId": "1.0.0",
    "createdAt": "2025-09-29T07:07:49.576782",
    "updatedAt": "2025-09-29T07:07:49.576788",
    "owner": "n8n-user",
    "license": "MIT",
    "category": "automation",
    "status": "active",
    "priority": "high",
    "environment": "production"
  },
  "tags": [
    "automation",
    "n8n",
    "production-ready",
    "excellent",
    "optimized"
  ],
  "notes": "Excellent quality workflow: Manualtrigger Workflow. This ...

Output:
This workflow may fail when receiving empty or null input data.

**Common Error Messages**:
- "Cannot read property 'x' of undefined"
- "No items to process"
- "Input data is empty"

**Root Cause**: The workflow doesn't handle cases where:
- Trigger receives no data
- Previous node returns empty array
- API returns null or empty response

**Solutions**:

1. **Add IF Node for Empty Check**:
```json
{
  "parameters": {
    "conditions": {
      "number": [{
        "value1": "={{ $json.length }}",
        "operation": "larger",
        "value2": 0
      }]
    }
  },
  "name": "Check Not Empty",
  "type": "n8n-nodes-base.if"
}
```

2. **Use Default Values**:
```javascript
{{ $json.field ?? "default_value" }}
{{ $json.items || [] }}
```

3. **Add Set Node with Defaults**:
- Create a Set node that provides default values
- Place it early in the workflow

4. **Implement No Match Output**:
- Many nodes have "No Match" outputs
- Use these to handle empty cases gracefully

**Best Practice**: Always validate input data and provide sensible defaults for optional fields.

Add validation for empty or null input data.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Rate Limiting Risk

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        250,
        300
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "53527830-3d53-4557-8b88-19eb5a6e80e2",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "Date & Time",
      "type": "n8n-nodes-base.dateTime",
      "position": [
        450,
        300
      ],
      "parameters": {
        "value": "14/02/2020",
        "options": {
          "fromFormat": "DD/MM/YYYY"
        }
      },
      "typeVersion": 1,
      "id": "9c456ae8-75a7-4e33-b3e1-aacbeaa12867",
      "notes": "This dateTime node performs automated tasks as part of the workflow."
    },
    {
      "id": "error-433015f5",
      "name": "Error Handler",
      "type": "n8n-nodes-base.stopAndError",
      "typeVersion": 1,
      "position": [
        1000,
        400
      ],
      "parameters": {
        "message": "Workflow execution error",
        "options": {}
      }
    },
    {
      "parameters": {
        "url": "https://api.example.com/data",
        "method": "GET",
        "options": {}
      },
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "position": [
        450,
        300
      ]
    }
  ],
  "connections": {},
  "name": "Manualtrigger Workflow",
  "description": "Automated workflow: Manualtrigger Workflow. This workflow processes data and performs automated tasks.",
  "settings": {
    "executionOrder": "v1",
    "saveManualExecutions": true,
    "callerPolicy": "workflowsFromSameOwner",
    "errorWorkflow": null,
    "timezone": "UTC",
    "executionTimeout": 3600,
    "maxExecutions": 1000,
    "retryOnFail": true,
    "retryCount": 3,
    "retryDelay": 1000
  },
  "meta": {
    "instanceId": "workflow-a4de64dd",
    "versionId": "1.0.0",
    "createdAt": "2025-09-29T07:07:49.574950",
    "updatedAt": "2025-09-29T07:07:49....

Output:
This workflow may encounter rate limiting issues when processing large batches of data.

**Common Rate Limit Errors**:
- HTTP 429 Too Many Requests
- HTTP 503 Service Unavailable
- API-specific rate limit messages

**Root Cause**: The workflow makes too many API requests in a short time period without delays.

**Solutions**:

1. **Add Wait Nodes**: Insert a Wait node between API calls
```json
{
  "parameters": {"amount": 1, "unit": "seconds"},
  "name": "Rate Limit Delay",
  "type": "n8n-nodes-base.wait"
}
```

2. **Enable Retry on Fail**:
```json
"retryOnFail": true,
"maxTries": 3,
"waitBetweenTries": 5000
```

3. **Use Batch Processing**: Split items into smaller batches with delays

4. **Implement Exponential Backoff**: Increase wait times with each retry

**Best Practice**: Always check API documentation for rate limits and implement appropriate throttling.

Add rate limiting protection with Wait nodes and retry logic.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Expression Reference Error

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        270,
        320
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "3968e372-d611-4be8-8b48-b00dda327d04",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "Read Binary File",
      "type": "n8n-nodes-base.readBinaryFile",
      "position": [
        470,
        320
      ],
      "parameters": {
        "filePath": "/data/picture.jpg"
      },
      "typeVersion": 1,
      "id": "4c17b39c-769e-4afd-9882-09509938f7b4",
      "notes": "This readBinaryFile node performs automated tasks as part of the workflow."
    },
    {
      "id": "error-e69b76e7",
      "name": "Error Handler",
      "type": "n8n-nodes-base.stopAndError",
      "typeVersion": 1,
      "position": [
        1000,
        400
      ],
      "parameters": {
        "message": "={{ $json.deeply.nested.undefined.path }}",
        "options": {}
      }
    }
  ],
  "connections": {},
  "name": "Manualtrigger Workflow",
  "description": "Automated workflow: Manualtrigger Workflow. This workflow processes data and performs automated tasks.",
  "settings": {
    "executionOrder": "v1",
    "saveManualExecutions": true,
    "callerPolicy": "workflowsFromSameOwner",
    "errorWorkflow": null,
    "timezone": "UTC",
    "executionTimeout": 3600,
    "maxExecutions": 1000,
    "retryOnFail": true,
    "retryCount": 3,
    "retryDelay": 1000
  },
  "meta": {
    "instanceId": "workflow-d70b4aed",
    "versionId": "1.0.0",
    "createdAt": "2025-09-29T07:07:49.576586",
    "updatedAt": "2025-09-29T07:07:49.576600",
    "owner": "n8n-user",
    "license": "MIT",
    "category": "automation",
    "status": "active",
    "priority": "high",
    "environment": "production"
  },
  "tags": [
    "automation",
    "n8n",
    "production-ready",
    "excellent",
    "optimized"
  ],
  "notes": "Exce...

Output:
In node 'Error Handler', the parameter 'message' contains an expression that references undefined data.

**Faulty Expression**: `={{ $json.deeply.nested.undefined.path }}`
**Original Value**: `Workflow execution error`

**Root Cause**: The expression references a field, node, or variable that doesn't exist in the data flow.

**Debugging Steps**:
1. Check the output of previous nodes to verify available fields
2. Use the Expression Editor to test expressions interactively
3. Add a Set node before this one to inspect available data
4. Use optional chaining for potentially undefined fields: `$json.field?.subfield`

**Best Practice**: Always validate data availability before using expressions.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Timeout Configuration

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        250,
        300
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "89b0437e-6883-4393-9a5e-31a6d479e291",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "Function",
      "type": "n8n-nodes-base.function",
      "position": [
        450,
        300
      ],
      "parameters": {
        "functionCode": "return [\n  {\n    json: {\n      id: 0,\n    }\n  },\n  {\n    json: {\n      id: 1,\n    }\n  }\n];"
      },
      "typeVersion": 1,
      "id": "b03b08d8-d92e-4607-9d11-7e7a5b8acbc7",
      "notes": "This function node performs automated tasks as part of the workflow."
    },
    {
      "name": "If Node",
      "type": "n8n-nodes-base.if",
      "position": [
        650,
        300
      ],
      "parameters": {
        "conditions": {
          "number": [
            {
              "value1": "={{$node[\"Function\"].json[\"id\"]}}",
              "operation": "equal"
            }
          ]
        }
      },
      "typeVersion": 1,
      "id": "4cc124a0-9fd6-45d0-b7ce-b0488d61e235",
      "notes": "This if node performs automated tasks as part of the workflow."
    },
    {
      "name": "Set",
      "type": "n8n-nodes-base.set",
      "position": [
        850,
        200
      ],
      "parameters": {
        "values": {
          "string": [
            {
              "name": "name",
              "value": "n8n"
            }
          ]
        },
        "options": {}
      },
      "typeVersion": 1,
      "id": "425bcfd6-525e-4ac3-94c7-9a92ae28ec85",
      "notes": "This set node performs automated tasks as part of the workflow."
    },
    {
      "name": "Set1",
      "type": "n8n-nodes-base.set",
      "position": [
        850,
        400
      ],
      "parameters": {
        "values": {
          "string": [
         ...

Output:
This workflow may experience timeout issues with long-running API requests.

**Symptoms**:
- Execution hangs indefinitely
- Connection timeout errors
- ETIMEDOUT or ESOCKETTIMEDOUT errors

**Root Cause**: No timeout configured for HTTP requests, or external services are slow.

**Solutions**:

1. **Set Appropriate Timeouts**:
```json
"options": {
  "timeout": 30000  // 30 seconds
}
```

2. **Add Error Handling**:
- Use Error Trigger node to catch timeout errors
- Implement fallback logic for failed requests

3. **Use Async Patterns**:
- For long operations, use webhook callbacks
- Implement polling patterns instead of waiting

4. **Configure Node Settings**:
```json
"retryOnFail": true,
"maxTries": 3,
"waitBetweenTries": 2000,
"continueOnFail": true
```

**Best Practice**: Set reasonable timeouts (10-30 seconds) and always have error handling for external API calls.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Data Type Mismatch

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        250,
        320
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "bc718648-966c-482f-8a66-a0df725b9422",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "Set",
      "type": "n8n-nodes-base.set",
      "position": [
        450,
        320
      ],
      "parameters": {
        "values": {
          "string": [
            {
              "name": "key",
              "value": "somevalue"
            }
          ]
        },
        "options": {},
        "_injected_number_field": "not_a_number"
      },
      "typeVersion": 1,
      "id": "0fd1bb1c-c0ea-4fd1-8dcf-08b1e8c8a2d7",
      "notes": "This set node performs automated tasks as part of the workflow."
    },
    {
      "name": "Rename Keys",
      "type": "n8n-nodes-base.renameKeys",
      "position": [
        650,
        320
      ],
      "parameters": {
        "keys": {
          "key": [
            {
              "newKey": "{{ $credentials.newKey }}",
              "currentKey": "{{ $credentials.currentKey }}"
            }
          ]
        }
      },
      "typeVersion": 1,
      "id": "ea93683b-59ce-4c6b-997f-40e9767d905a",
      "notes": "This renameKeys node performs automated tasks as part of the workflow."
    },
    {
      "id": "error-aeb41a3c",
      "name": "Error Handler",
      "type": "n8n-nodes-base.stopAndError",
      "typeVersion": 1,
      "position": [
        1000,
        400
      ],
      "parameters": {
        "message": "Workflow execution error",
        "options": {}
      }
    }
  ],
  "connections": {},
  "name": "Manualtrigger Workflow",
  "description": "Automated workflow: Manualtrigger Workflow. This workflow processes data and performs automated tasks.",
  "settings": {
    "executionOrder": "v1",
    "saveManualExecutions": true,
    "cal...

Output:
The node 'Set' has a data type mismatch in its parameters.

**Issue**: A field expected a number but received a string value.

**Common Causes**:
1. Expression returns string instead of number
2. JSON parsing preserves string types for numeric values
3. Upstream node outputs different data types than expected

**Solutions**:

1. **Type Conversion in Expression**:
```javascript
// Convert string to number
{ parseInt($json.stringValue) }
{ parseFloat($json.decimalString) }
{ Number($json.value) }
```

2. **Use Code Node for Transformation**:
```javascript
return items.map(item => {
  item.json.numericField = Number(item.json.stringField);
  return item;
});
```

3. **Validate Data Types**:
- Use IF node to check types before processing
- Add error handling for invalid types

**Best Practice**: Always validate and transform data types explicitly when passing data between nodes.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Syntax Error

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "nodes" [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        260,
        320
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "3161034e-a6cf-45e1-925a-9972c747b4ce",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "RSS Feed Read",
      "type": "n8n-nodes-base.rssFeedRead",
      "position": [
        460,
        320
      ],
      "parameters": {
        "url": "{{ $env.WEBHOOK_URL }}"
      },
      "typeVersion": 1,
      "id": "0f87d76b-e210-4c05-a735-ac5d7a42295e",
      "notes": "This rssFeedRead node performs automated tasks as part of the workflow."
    },
    {
      "id": "error-8c332aaf",
      "name": "Error Handler",
      "type": "n8n-nodes-base.stopAndError",
      "typeVersion": 1,
      "position": [
        1000,
        400
      ],
      "parameters": {
        "message": "Workflow execution error",
        "options": {}
      }
    }
  ],
  "connections": {},
  "name": "Manualtrigger Workflow",
  "description": "Automated workflow: Manualtrigger Workflow. This workflow processes data and performs automated tasks.",
  "settings": {
    "executionOrder": "v1",
    "saveManualExecutions": true,
    "callerPolicy": "workflowsFromSameOwner",
    "errorWorkflow": null,
    "timezone": "UTC",
    "executionTimeout": 3600,
    "maxExecutions": 1000,
    "retryOnFail": true,
    "retryCount": 3,
    "retryDelay": 1000
  },
  "meta": {
    "instanceId": "workflow-e88d1cc0",
    "versionId": "1.0.0",
    "createdAt": "2025-09-29T07:07:49.593153",
    "updatedAt": "2025-09-29T07:07:49.593160",
    "owner": "n8n-user",
    "license": "MIT",
    "category": "automation",
    "status": "active",
    "priority": "high",
    "environment": "production"
  },
  "tags": [
    "automation",
    "n8n",
    "production-ready",
    "excellent",
    "optimized"
  ],
  "notes": "Excellent quality workflow: Man...

Output: The JSON is missing a colon between a key and its value. JSON requires colons to separate keys from values.

Add the missing colon after the property name.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Timeout Configuration

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        250,
        300
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "47fb9089-2a84-47d0-886d-9eba9dbd2b72",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "Send Email",
      "type": "n8n-nodes-base.emailSend",
      "position": [
        450,
        300
      ],
      "parameters": {
        "text": "This is a message to demonstrate the n8n Send Email workflow!",
        "options": {
          "allowUnauthorizedCerts": false
        },
        "subject": "n8n rocks!",
        "toEmail": "user@example.com",
        "fromEmail": "user@from.email"
      },
      "credentials": {
        "smtp": "your@smtp_creds.here"
      },
      "typeVersion": 1,
      "id": "6550c7a4-6433-46cd-a2e8-a7d7df90fbe2",
      "notes": "This emailSend node performs automated tasks as part of the workflow."
    }
  ],
  "connections": {
    "6550c7a4-6433-46cd-a2e8-a7d7df90fbe2": {
      "main": [
        [
          {
            "node": "error-handler-6550c7a4-6433-46cd-a2e8-a7d7df90fbe2-9c4f07bd",
            "type": "main",
            "index": 0
          }
        ],
        [
          {
            "node": "error-handler-6550c7a4-6433-46cd-a2e8-a7d7df90fbe2-3fea6167",
            "type": "main",
            "index": 0
          }
        ],
        [
          {
            "node": "error-handler-6550c7a4-6433-46cd-a2e8-a7d7df90fbe2-85d67252",
            "type": "main",
            "index": 0
          }
        ],
        [
          {
            "node": "error-handler-6550c7a4-6433-46cd-a2e8-a7d7df90fbe2-23478388",
            "type": "main",
            "index": 0
          }
        ],
        [
          {
            "node": "error-handler-6550c7a4-6433-46cd-a2e8-a7d7df90fbe2-60bf1693",
            "type": "main",
            "index": 0
          }
     ...

Output:
This workflow may experience timeout issues with long-running API requests.

**Symptoms**:
- Execution hangs indefinitely
- Connection timeout errors
- ETIMEDOUT or ESOCKETTIMEDOUT errors

**Root Cause**: No timeout configured for HTTP requests, or external services are slow.

**Solutions**:

1. **Set Appropriate Timeouts**:
```json
"options": {
  "timeout": 30000  // 30 seconds
}
```

2. **Add Error Handling**:
- Use Error Trigger node to catch timeout errors
- Implement fallback logic for failed requests

3. **Use Async Patterns**:
- For long operations, use webhook callbacks
- Implement polling patterns instead of waiting

4. **Configure Node Settings**:
```json
"retryOnFail": true,
"maxTries": 3,
"waitBetweenTries": 2000,
"continueOnFail": true
```

**Best Practice**: Set reasonable timeouts (10-30 seconds) and always have error handling for external API calls.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Empty Input Handling

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        680,
        400
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "a7eeebb8-a67d-4ffa-8615-c1757c870e0e",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "Read Binary File",
      "type": "n8n-nodes-base.readBinaryFile",
      "position": [
        880,
        400
      ],
      "parameters": {
        "filePath": "/data/pdf.pdf"
      },
      "typeVersion": 1,
      "id": "7bbb769c-4a3b-4670-8d23-70032e673ac4",
      "notes": "This readBinaryFile node performs automated tasks as part of the workflow."
    },
    {
      "name": "Read PDF",
      "type": "n8n-nodes-base.readPDF",
      "position": [
        1090,
        400
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "31f574ef-73c5-4a24-8819-4b55553705f4",
      "notes": "This readPDF node performs automated tasks as part of the workflow."
    },
    {
      "id": "error-acd039e9",
      "name": "Error Handler",
      "type": "n8n-nodes-base.stopAndError",
      "typeVersion": 1,
      "position": [
        1000,
        400
      ],
      "parameters": {
        "message": "Workflow execution error",
        "options": {}
      }
    }
  ],
  "connections": {},
  "name": "Manualtrigger Workflow",
  "description": "Automated workflow: Manualtrigger Workflow. This workflow processes data and performs automated tasks.",
  "settings": {
    "executionOrder": "v1",
    "saveManualExecutions": true,
    "callerPolicy": "workflowsFromSameOwner",
    "errorWorkflow": null,
    "timezone": "UTC",
    "executionTimeout": 3600,
    "maxExecutions": 1000,
    "retryOnFail": true,
    "retryCount": 3,
    "retryDelay": 1000
  },
  "meta": {
    "instanceId": "workflow-702aa19a",
    "versionId": "1.0.0",
    "createdAt": "2025-09-29T07:07:49.592475",
    "updatedAt": "2025-09-29T0...

Output:
This workflow may fail when receiving empty or null input data.

**Common Error Messages**:
- "Cannot read property 'x' of undefined"
- "No items to process"
- "Input data is empty"

**Root Cause**: The workflow doesn't handle cases where:
- Trigger receives no data
- Previous node returns empty array
- API returns null or empty response

**Solutions**:

1. **Add IF Node for Empty Check**:
```json
{
  "parameters": {
    "conditions": {
      "number": [{
        "value1": "={{ $json.length }}",
        "operation": "larger",
        "value2": 0
      }]
    }
  },
  "name": "Check Not Empty",
  "type": "n8n-nodes-base.if"
}
```

2. **Use Default Values**:
```javascript
{{ $json.field ?? "default_value" }}
{{ $json.items || [] }}
```

3. **Add Set Node with Defaults**:
- Create a Set node that provides default values
- Place it early in the workflow

4. **Implement No Match Output**:
- Many nodes have "No Match" outputs
- Use these to handle empty cases gracefully

**Best Practice**: Always validate input data and provide sensible defaults for optional fields.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Timeout Configuration

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        250,
        320
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "e8ce2225-f0fd-44c1-bdd6-280feca0abf9",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "Spreadsheet File",
      "type": "n8n-nodes-base.spreadsheetFile",
      "position": [
        650,
        320
      ],
      "parameters": {
        "options": {}
      },
      "typeVersion": 1,
      "id": "6c6b514b-5f3f-43f7-ba0f-530cd536bc66",
      "notes": "This spreadsheetFile node performs automated tasks as part of the workflow."
    },
    {
      "name": "Read Binary File",
      "type": "n8n-nodes-base.readBinaryFile",
      "position": [
        450,
        320
      ],
      "parameters": {
        "filePath": "/data/sample_spreadsheet.csv"
      },
      "typeVersion": 1,
      "id": "d5778d51-0f36-4839-86c4-4d4e872f8ebf",
      "notes": "This readBinaryFile node performs automated tasks as part of the workflow."
    },
    {
      "id": "error-e45dc873",
      "name": "Error Handler",
      "type": "n8n-nodes-base.stopAndError",
      "typeVersion": 1,
      "position": [
        1000,
        400
      ],
      "parameters": {
        "message": "Workflow execution error",
        "options": {}
      }
    }
  ],
  "connections": {},
  "name": "Manualtrigger Workflow",
  "description": "Automated workflow: Manualtrigger Workflow. This workflow processes data and performs automated tasks.",
  "settings": {
    "executionOrder": "v1",
    "saveManualExecutions": true,
    "callerPolicy": "workflowsFromSameOwner",
    "errorWorkflow": null,
    "timezone": "UTC",
    "executionTimeout": 3600,
    "maxExecutions": 1000,
    "retryOnFail": true,
    "retryCount": 3,
    "retryDelay": 1000
  },
  "meta": {
    "instanceId": "workflow-e80f7eaa",
    "versionId": "1.0.0",
    "creat...

Output:
This workflow may experience timeout issues with long-running API requests.

**Symptoms**:
- Execution hangs indefinitely
- Connection timeout errors
- ETIMEDOUT or ESOCKETTIMEDOUT errors

**Root Cause**: No timeout configured for HTTP requests, or external services are slow.

**Solutions**:

1. **Set Appropriate Timeouts**:
```json
"options": {
  "timeout": 30000  // 30 seconds
}
```

2. **Add Error Handling**:
- Use Error Trigger node to catch timeout errors
- Implement fallback logic for failed requests

3. **Use Async Patterns**:
- For long operations, use webhook callbacks
- Implement polling patterns instead of waiting

4. **Configure Node Settings**:
```json
"retryOnFail": true,
"maxTries": 3,
"waitBetweenTries": 2000,
"continueOnFail": true
```

**Best Practice**: Set reasonable timeouts (10-30 seconds) and always have error handling for external API calls.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Empty Input Handling

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        220,
        340
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "8ac859fd-8f8a-46a2-ae2d-dc32ac55dd99",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "Execute Workflow",
      "type": "n8n-nodes-base.executeWorkflow",
      "position": [
        410,
        340
      ],
      "parameters": {
        "workflowId": "1"
      },
      "typeVersion": 1,
      "id": "2527eb37-3ba6-44dd-979b-6a864db9c23e",
      "notes": "This executeWorkflow node performs automated tasks as part of the workflow."
    },
    {
      "id": "error-97dfe388",
      "name": "Error Handler",
      "type": "n8n-nodes-base.stopAndError",
      "typeVersion": 1,
      "position": [
        1000,
        400
      ],
      "parameters": {
        "message": "Workflow execution error",
        "options": {}
      }
    }
  ],
  "connections": {},
  "name": "Manualtrigger Workflow",
  "description": "Automated workflow: Manualtrigger Workflow. This workflow processes data and performs automated tasks.",
  "settings": {
    "executionOrder": "v1",
    "saveManualExecutions": true,
    "callerPolicy": "workflowsFromSameOwner",
    "errorWorkflow": null,
    "timezone": "UTC",
    "executionTimeout": 3600,
    "maxExecutions": 1000,
    "retryOnFail": true,
    "retryCount": 3,
    "retryDelay": 1000
  },
  "meta": {
    "instanceId": "workflow-88327fd4",
    "versionId": "1.0.0",
    "createdAt": "2025-09-29T07:07:49.608272",
    "updatedAt": "2025-09-29T07:07:49.608288",
    "owner": "n8n-user",
    "license": "MIT",
    "category": "automation",
    "status": "active",
    "priority": "high",
    "environment": "production"
  },
  "tags": [
    "automation",
    "n8n",
    "production-ready",
    "excellent",
    "optimized"
  ],
  "notes": "Excellent quality workflow: Manua...

Output:
This workflow may fail when receiving empty or null input data.

**Common Error Messages**:
- "Cannot read property 'x' of undefined"
- "No items to process"
- "Input data is empty"

**Root Cause**: The workflow doesn't handle cases where:
- Trigger receives no data
- Previous node returns empty array
- API returns null or empty response

**Solutions**:

1. **Add IF Node for Empty Check**:
```json
{
  "parameters": {
    "conditions": {
      "number": [{
        "value1": "={{ $json.length }}",
        "operation": "larger",
        "value2": 0
      }]
    }
  },
  "name": "Check Not Empty",
  "type": "n8n-nodes-base.if"
}
```

2. **Use Default Values**:
```javascript
{{ $json.field ?? "default_value" }}
{{ $json.items || [] }}
```

3. **Add Set Node with Defaults**:
- Create a Set node that provides default values
- Place it early in the workflow

4. **Implement No Match Output**:
- Many nodes have "No Match" outputs
- Use these to handle empty cases gracefully

**Best Practice**: Always validate input data and provide sensible defaults for optional fields.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Syntax Error

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "id": "58",
  "name": "Turn on a light and set its brightness",
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        590,
        260
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "5c8f8497-7182-4015-92d8-7d9a7a7567bd",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "Philips Hue",
      "type": "n8n-nodes-base.philipsHue",
      "position": [
        790,
        260
      ],
      "parameters": {
        "lightId": "123",
        "additionalFields": {
          "bri": 90
        }
      },
      "credentials": {
        "philipsHueOAuth2Api": "philips-hue"
      },
      "typeVersion": 1,
      "id": "c5275016-dc2b-46c7-8d32-d823cc1893c0",
      "notes": "This philipsHue node performs automated tasks as part of the workflow."
    },
    {
      "id": "error-97cd67b4",
      "name": "Error Handler",
      "type": "n8n-nodes-base.stopAndError",
      "typeVersion": 1,
      "position": [
        1000,
        400
      ],
      "parameters": {
        "message": "Workflow execution error",
        "options": {}
      }
    }
  ],
  "active": false,
  "settings": {
    "executionOrder": "v1",
    "saveManualExecutions": true,
    "callerPolicy": "workflowsFromSameOwner",
    "errorWorkflow": null,
    "timezone": "UTC",
    "executionTimeout": 3600,
    "maxExecutions": 1000,
    "retryOnFail": true,
    "retryCount": 3,
    "retryDelay": 1000
  },
  "connections": {},
  "description": "Automated workflow: Turn on a light and set its brightness. This workflow processes data and performs automated tasks.",
  "meta": {
    "instanceId": "workflow-127248a8",
    "versionId": "1.0.0",
    "createdAt": "2025-09-29T07:07:49.613467",
    "updatedAt": "2025-09-29T07:07:49.613474",
    "owner": "n8n-user",
    "license": "MIT",
    "category": "automation",
    "status": "active",
    "priority": "high"...

Output: The JSON is invalid because it is missing a closing brace '}' at the end of the file. Add the missing '}' to close the workflow object.

Add a closing brace '}' at the end of the JSON.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Empty Input Handling

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        460,
        230
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "ce1eb445-2e8c-4333-a844-b2d807ff51e0",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "MySQL",
      "type": "n8n-nodes-base.mySql",
      "position": [
        660,
        230
      ],
      "parameters": {
        "query": "CREATE TABLE test (id INT, name VARCHAR(255), PRIMARY KEY (id));",
        "operation": "executeQuery"
      },
      "credentials": {
        "mySql": "mysql_creds"
      },
      "typeVersion": 1,
      "id": "18e7b906-9633-424d-8e7f-89ccf9a4b4ab",
      "notes": "This mySql node performs automated tasks as part of the workflow."
    },
    {
      "name": "MySQL1",
      "type": "n8n-nodes-base.mySql",
      "position": [
        1060,
        230
      ],
      "parameters": {
        "table": "test",
        "columns": "id, name"
      },
      "credentials": {
        "mySql": "mysql_creds"
      },
      "typeVersion": 1,
      "id": "f3d5e1a1-1df9-400c-85c3-809f8f4275c8",
      "notes": "This mySql node performs automated tasks as part of the workflow."
    },
    {
      "name": "Set",
      "type": "n8n-nodes-base.set",
      "position": [
        860,
        230
      ],
      "parameters": {
        "values": {
          "number": [
            {
              "name": "id"
            }
          ],
          "string": [
            {
              "name": "name",
              "value": "n8n"
            }
          ]
        },
        "options": {},
        "keepOnlySet": true
      },
      "typeVersion": 1,
      "alwaysOutputData": false,
      "id": "e5191159-d996-4db6-a06f-080d37c8c4e8",
      "notes": "This set node performs automated tasks as part of the workflow."
    },
    {
      "id": "error-71502e36",
      "name": "Error Handler...

Output:
This workflow may fail when receiving empty or null input data.

**Common Error Messages**:
- "Cannot read property 'x' of undefined"
- "No items to process"
- "Input data is empty"

**Root Cause**: The workflow doesn't handle cases where:
- Trigger receives no data
- Previous node returns empty array
- API returns null or empty response

**Solutions**:

1. **Add IF Node for Empty Check**:
```json
{
  "parameters": {
    "conditions": {
      "number": [{
        "value1": "={{ $json.length }}",
        "operation": "larger",
        "value2": 0
      }]
    }
  },
  "name": "Check Not Empty",
  "type": "n8n-nodes-base.if"
}
```

2. **Use Default Values**:
```javascript
{{ $json.field ?? "default_value" }}
{{ $json.items || [] }}
```

3. **Add Set Node with Defaults**:
- Create a Set node that provides default values
- Place it early in the workflow

4. **Implement No Match Output**:
- Many nodes have "No Match" outputs
- Use these to handle empty cases gracefully

**Best Practice**: Always validate input data and provide sensible defaults for optional fields.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Missing Credentials

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        260,
        290
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "08b09726-9cfd-4219-aa91-774cd0e38899",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "Set",
      "type": "n8n-nodes-base.set",
      "position": [
        660,
        290
      ],
      "parameters": {
        "values": {
          "number": [
            {
              "name": "id"
            }
          ],
          "string": [
            {
              "name": "name",
              "value": "n8n"
            }
          ]
        },
        "options": {}
      },
      "typeVersion": 1,
      "alwaysOutputData": false,
      "id": "85fd2976-0cf4-49dc-9038-4e23043a3f72",
      "notes": "This set node performs automated tasks as part of the workflow."
    },
    {
      "name": "Postgres",
      "type": "n8n-nodes-base.postgres",
      "position": [
        460,
        290
      ],
      "parameters": {
        "query": "CREATE TABLE test (id INT, name VARCHAR(255), PRIMARY KEY (id));",
        "operation": "executeQuery"
      },
      "typeVersion": 1,
      "alwaysOutputData": true,
      "id": "0695202f-4805-46fd-bc45-cc3109715362",
      "notes": "This postgres node performs automated tasks as part of the workflow."
    },
    {
      "name": "Postgres1",
      "type": "n8n-nodes-base.postgres",
      "position": [
        860,
        290
      ],
      "parameters": {
        "table": "test",
        "columns": "id, name"
      },
      "credentials": {
        "postgres": "postgres_docker_creds"
      },
      "typeVersion": 1,
      "id": "9f2b3e96-01f7-4fc9-a05f-b270731c79e3",
      "notes": "This postgres node performs automated tasks as part of the workflow."
    },
    {
      "id": "error-53637849",
      "name": "Error Handler",
      "type": "n8n-nodes-ba...

Output:
The node 'Postgres' (type: n8n-nodes-base.postgres) requires credentials but the 'credentials' configuration is missing.

**Root Cause**: The credentials object was not defined for this node.

**Solution**: Add the credentials configuration back to the node:
```json
"credentials": {
  "postgres": "postgres_docker_creds"
}
```

**Best Practice**: Always verify credentials are properly configured before deploying workflows. Use n8n's credential management system to store sensitive data securely.

Add credentials configuration to the 'Postgres' node.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Expression Reference Error

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "id": "5",
  "name": "Append, lookup, update, and read data from a Google Sheets spreadsheet",
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        450,
        450
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "dd536ac6-fa16-4bf8-b07c-06fd82aa94c4",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "Google Sheets2",
      "type": "n8n-nodes-base.googleSheets",
      "position": [
        1450,
        450
      ],
      "parameters": {
        "key": "YOUR_CREDENTIAL_HERE",
        "range": "A:D",
        "options": {
          "valueInputMode": "USER_ENTERED",
          "valueRenderMode": "UNFORMATTED_VALUE"
        },
        "sheetId": "1remFwo--5ehUgIU7UUndKldPI0Xm93e1T3DldD9GOg0",
        "operation": "update",
        "authentication": "{{ $credentials.oAuth2 }}"
      },
      "credentials": {
        "googleSheetsOAuth2Api": "google-sheet"
      },
      "typeVersion": 1,
      "id": "003db6d4-b010-4ee6-9ba2-f146cd61472e",
      "notes": "This googleSheets node performs automated tasks as part of the workflow."
    },
    {
      "name": "Set1",
      "type": "n8n-nodes-base.set",
      "position": [
        1250,
        450
      ],
      "parameters": {
        "values": {
          "number": [
            {
              "name": "Rent",
              "value": "={{$node[\"Google Sheets1\"].json[\"Rent\"]+100}}"
            },
            {
              "name": "ID",
              "value": "={{$node[\"Google Sheets1\"].json[\"ID\"]}}"
            }
          ],
          "string": [
            {
              "name": "Name",
              "value": "={{$node[\"Google Sheets1\"].json[\"Name\"]}}"
            },
            {
              "name": "City",
              "value": "={{$node[\"Google Sheets1\"].json[\"City\"]}}"
            }
          ]
        },
        "options": {},
 ...

Output:
In node 'Google Sheets3', the parameter 'range' contains an expression that references undefined data.

**Faulty Expression**: `={{ $items[999].json.value }}`
**Original Value**: `A:D`

**Root Cause**: The expression references a field, node, or variable that doesn't exist in the data flow.

**Debugging Steps**:
1. Check the output of previous nodes to verify available fields
2. Use the Expression Editor to test expressions interactively
3. Add a Set node before this one to inspect available data
4. Use optional chaining for potentially undefined fields: `$json.field?.subfield`

**Best Practice**: Always validate data availability before using expressions.

Fix the expression in 'Google Sheets3' parameter 'range'.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Syntax Error

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "id": "5:
  "name": "Manualtrigger Workflow",
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        540,
        350
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "81bd525e-1bb0-42c6-8751-19e505c677be",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "Github",
      "type": "n8n-nodes-base.github",
      "position": [
        790,
        350
      ],
      "parameters": {
        "owner": "n8n-io",
        "resource": "repository",
        "operation": "getProfile",
        "repository": "n8n"
      },
      "credentials": {
        "githubApi": "shraddha"
      },
      "typeVersion": 1,
      "id": "368f4b6a-84fb-4bbd-a13b-8579dd2ffabb",
      "notes": "This github node performs automated tasks as part of the workflow."
    },
    {
      "id": "error-c28d6bb3",
      "name": "Error Handler",
      "type": "n8n-nodes-base.stopAndError",
      "typeVersion": 1,
      "position": [
        1000,
        400
      ],
      "parameters": {
        "message": "Workflow execution error",
        "options": {}
      }
    }
  ],
  "active": false,
  "settings": {
    "executionOrder": "v1",
    "saveManualExecutions": true,
    "callerPolicy": "workflowsFromSameOwner",
    "errorWorkflow": null,
    "timezone": "UTC",
    "executionTimeout": 3600,
    "maxExecutions": 1000,
    "retryOnFail": true,
    "retryCount": 3,
    "retryDelay": 1000
  },
  "connections": {},
  "description": "Automated workflow: Manualtrigger Workflow. This workflow processes data and performs automated tasks.",
  "meta": {
    "instanceId": "workflow-2907e798",
    "versionId": "1.0.0",
    "createdAt": "2025-09-29T07:07:49.639704",
    "updatedAt": "2025-09-29T07:07:49.639723",
    "owner": "n8n-user",
    "license": "MIT",
    "category": "automation",
    "status": "active",
    "priority": "high",
    "environment": "...

Output: The JSON contains an unclosed string. All string values must be enclosed in double quotes.

Add the missing closing quote to complete the string.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Timeout Configuration

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        250,
        300
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "46c740b3-783c-4bf2-b9de-dd5447c52796",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "Google Sheets",
      "type": "n8n-nodes-base.googleSheets",
      "position": [
        650,
        300
      ],
      "parameters": {
        "range": "A:B",
        "options": {},
        "sheetId": "1ijnLMy6htVTX_68e2lsdGYiA5_6ZG72FXUbxAy_DC94",
        "operation": "append",
        "authentication": "{{ $credentials.oAuth2 }}"
      },
      "credentials": {
        "googleSheetsOAuth2Api": "Amudhan-GoogleSheets"
      },
      "typeVersion": 1,
      "id": "9d31ee48-b5f6-4f63-80e1-dd7d70618525",
      "notes": "This googleSheets node performs automated tasks as part of the workflow."
    },
    {
      "name": "Set",
      "type": "n8n-nodes-base.set",
      "position": [
        450,
        300
      ],
      "parameters": {
        "values": {
          "number": [
            {
              "name": "id"
            }
          ],
          "string": [
            {
              "name": "name",
              "value": "n8n"
            }
          ]
        },
        "options": {}
      },
      "typeVersion": 1,
      "alwaysOutputData": true,
      "id": "cadc1f54-d36c-4236-b636-82558426a7a2",
      "notes": "This set node performs automated tasks as part of the workflow."
    },
    {
      "name": "Google Sheets1",
      "type": "n8n-nodes-base.googleSheets",
      "position": [
        850,
        300
      ],
      "parameters": {
        "range": "A:B",
        "options": {},
        "sheetId": "1ijnLMy6htVTX_68e2lsdGYiA5_6ZG72FXUbxAy_DC94",
        "authentication": "{{ $credentials.oAuth2 }}"
      },
      "credentials": {
        "googleSheetsOAuth2Api": "Amudhan-Google...

Output:
This workflow may experience timeout issues with long-running API requests.

**Symptoms**:
- Execution hangs indefinitely
- Connection timeout errors
- ETIMEDOUT or ESOCKETTIMEDOUT errors

**Root Cause**: No timeout configured for HTTP requests, or external services are slow.

**Solutions**:

1. **Set Appropriate Timeouts**:
```json
"options": {
  "timeout": 30000  // 30 seconds
}
```

2. **Add Error Handling**:
- Use Error Trigger node to catch timeout errors
- Implement fallback logic for failed requests

3. **Use Async Patterns**:
- For long operations, use webhook callbacks
- Implement polling patterns instead of waiting

4. **Configure Node Settings**:
```json
"retryOnFail": true,
"maxTries": 3,
"waitBetweenTries": 2000,
"continueOnFail": true
```

**Best Practice**: Set reasonable timeouts (10-30 seconds) and always have error handling for external API calls.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Data Type Mismatch

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "id": "60",
  "name": "Create a post and update the post in WordPress",
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        570,
        260
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "7b9644ed-1111-4b4f-bd51-11d4c86dd19d",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "Wordpress",
      "type": "n8n-nodes-base.wordpress",
      "position": [
        770,
        260
      ],
      "parameters": {
        "title": "created from n8n",
        "additionalFields": {}
      },
      "credentials": {
        "wordpressApi": "wordpress"
      },
      "typeVersion": 1,
      "id": "929be13b-0ded-4e54-8dfa-e7e8b573cdb9",
      "notes": "This wordpress node performs automated tasks as part of the workflow."
    },
    {
      "name": "Wordpress1",
      "type": "n8n-nodes-base.wordpress",
      "position": [
        970,
        260
      ],
      "parameters": {
        "postId": "={{$node[\"Wordpress\"].json[\"id\"]}}",
        "operation": "update",
        "updateFields": {
          "content": "This post was created using the n8n workflow."
        }
      },
      "credentials": {
        "wordpressApi": "wordpress"
      },
      "typeVersion": 1,
      "id": "700e12f7-6ae8-4d3f-becc-73fc8f59bf23",
      "notes": "This wordpress node performs automated tasks as part of the workflow."
    },
    {
      "id": "error-2808f1f7",
      "name": "Error Handler",
      "type": "n8n-nodes-base.stopAndError",
      "typeVersion": 1,
      "position": [
        1000,
        400
      ],
      "parameters": {
        "message": "Workflow execution error",
        "options": {},
        "_injected_number_field": "not_a_number"
      }
    }
  ],
  "active": false,
  "settings": {
    "executionOrder": "v1",
    "saveManualExecutions": true,
    "callerPolicy": "workflowsFromSameOwner",
    "errorWor...

Output:
The node 'Error Handler' has a data type mismatch in its parameters.

**Issue**: A field expected a number but received a string value.

**Common Causes**:
1. Expression returns string instead of number
2. JSON parsing preserves string types for numeric values
3. Upstream node outputs different data types than expected

**Solutions**:

1. **Type Conversion in Expression**:
```javascript
// Convert string to number
{ parseInt($json.stringValue) }
{ parseFloat($json.decimalString) }
{ Number($json.value) }
```

2. **Use Code Node for Transformation**:
```javascript
return items.map(item => {
  item.json.numericField = Number(item.json.stringField);
  return item;
});
```

3. **Validate Data Types**:
- Use IF node to check types before processing
- Add error handling for invalid types

**Best Practice**: Always validate and transform data types explicitly when passing data between nodes.

Fix data type conversion in 'Error Handler'.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Expression Reference Error

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "id": "60",
  "name": "n8n_mysql_purge_history_greater_than_10_days",
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        250,
        300
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "199a3ed7-a9a9-4179-b644-568018c2dc91",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "MySQL",
      "type": "n8n-nodes-base.mySql",
      "position": [
        450,
        300
      ],
      "parameters": {
        "query": "={{ $node.NonExistentNode.json.data }}",
        "operation": "executeQuery"
      },
      "credentials": {
        "mySql": "n8n"
      },
      "typeVersion": 1,
      "id": "45b6edb0-422f-41aa-9209-b0a2071bda9f",
      "notes": "This mySql node performs automated tasks as part of the workflow."
    },
    {
      "name": "Cron",
      "type": "n8n-nodes-base.cron",
      "position": [
        250,
        460
      ],
      "parameters": {
        "triggerTimes": {
          "item": [
            {
              "hour": 7
            }
          ]
        }
      },
      "typeVersion": 1,
      "id": "558f5fca-18d5-44bd-adbc-829fa828d9ad",
      "notes": "This cron node performs automated tasks as part of the workflow."
    },
    {
      "id": "error-cf33a401",
      "name": "Error Handler",
      "type": "n8n-nodes-base.stopAndError",
      "typeVersion": 1,
      "position": [
        1000,
        400
      ],
      "parameters": {
        "message": "Workflow execution error",
        "options": {}
      }
    }
  ],
  "active": true,
  "settings": {
    "executionOrder": "v1",
    "saveManualExecutions": true,
    "callerPolicy": "workflowsFromSameOwner",
    "errorWorkflow": null,
    "timezone": "UTC",
    "executionTimeout": 3600,
    "maxExecutions": 1000,
    "retryOnFail": true,
    "retryCount": 3,
    "retryDelay": 1000
  },
  "connections": {},
  "description": "Auto...

Output:
In node 'MySQL', the parameter 'query' contains an expression that references undefined data.

**Faulty Expression**: `={{ $node.NonExistentNode.json.data }}`
**Original Value**: `DELETE FROM execution_entity
WHERE DATE(stoppedAt) < DATE_SUB(CURDATE(), INTERVAL 30 DAY)`

**Root Cause**: The expression references a field, node, or variable that doesn't exist in the data flow.

**Debugging Steps**:
1. Check the output of previous nodes to verify available fields
2. Use the Expression Editor to test expressions interactively
3. Add a Set node before this one to inspect available data
4. Use optional chaining for potentially undefined fields: `$json.field?.subfield`

**Best Practice**: Always validate data availability before using expressions.

Fix the expression in 'MySQL' parameter 'query'.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Missing Credentials

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        50,
        200
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "node-f3594ad6"
    },
    {
      "name": "Dropbox",
      "type": "n8n-nodes-base.dropbox",
      "position": [
        250,
        200
      ],
      "parameters": {
        "path": "/n8n",
        "resource": "folder"
      },
      "typeVersion": 1,
      "id": "node-f46b1aff"
    },
    {
      "name": "Dropbox1",
      "type": "n8n-nodes-base.dropbox",
      "position": [
        650,
        200
      ],
      "parameters": {
        "path": "/n8n/file.png",
        "binaryData": true
      },
      "credentials": {
        "dropboxApi": "dropbox_accesstoken"
      },
      "typeVersion": 1,
      "id": "node-a72a6bab"
    },
    {
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "position": [
        450,
        200
      ],
      "parameters": {
        "url": "{{ $env.BASE_URL }}",
        "options": {},
        "responseFormat": "file"
      },
      "typeVersion": 1,
      "id": "node-6a18e38e"
    },
    {
      "name": "Dropbox2",
      "type": "n8n-nodes-base.dropbox",
      "position": [
        850,
        200
      ],
      "parameters": {
        "path": "/n8n",
        "resource": "folder",
        "operation": "list"
      },
      "credentials": {
        "dropboxApi": "dropbox_accesstoken"
      },
      "typeVersion": 1,
      "id": "node-f173f16a"
    },
    {
      "id": "error-90090500",
      "name": "Error Handler",
      "type": "n8n-nodes-base.stopAndError",
      "typeVersion": 1,
      "position": [
        1000,
        400
      ],
      "parameters": {
        "message": "Workflow execution error",
        "options": {}
      }
    }
  ],
  "connections": {},
  "name": "Production Workflow",
  "settings": {
    "executionOrder": "v1",
    "saveManualExecutions": true,
    "callerPo...

Output:
The node 'Dropbox' (type: n8n-nodes-base.dropbox) requires credentials but the 'credentials' configuration is missing.

**Root Cause**: The credentials object was not defined for this node.

**Solution**: Add the credentials configuration back to the node:
```json
"credentials": {
  "dropboxApi": "dropbox_accesstoken"
}
```

**Best Practice**: Always verify credentials are properly configured before deploying workflows. Use n8n's credential management system to store sensitive data securely.

Add credentials configuration to the 'Dropbox' node.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Timeout Configuration

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        20,
        180
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "node-5c97b9e8"
    },
    {
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "position": [
        420,
        180
      ],
      "parameters": {
        "url": "{{ $env.BASE_URL }}",
        "options": {},
        "responseFormat": "file"
      },
      "typeVersion": 1,
      "id": "node-6a19e34e"
    },
    {
      "name": "NextCloud",
      "type": "n8n-nodes-base.nextCloud",
      "position": [
        220,
        180
      ],
      "parameters": {
        "path": "n8n",
        "resource": "folder"
      },
      "credentials": {
        "nextCloudApi": "nextcloud_creds"
      },
      "typeVersion": 1,
      "id": "node-b06f9be3"
    },
    {
      "name": "NextCloud1",
      "type": "n8n-nodes-base.nextCloud",
      "position": [
        620,
        180
      ],
      "parameters": {
        "path": "n8n/logo.png",
        "binaryDataUpload": true
      },
      "credentials": {
        "nextCloudApi": "nextcloud_creds"
      },
      "typeVersion": 1,
      "id": "node-7715dfe4"
    },
    {
      "name": "NextCloud2",
      "type": "n8n-nodes-base.nextCloud",
      "position": [
        820,
        180
      ],
      "parameters": {
        "path": "n8n",
        "resource": "folder",
        "operation": "list"
      },
      "credentials": {
        "nextCloudApi": "nextcloud_creds"
      },
      "typeVersion": 1,
      "id": "node-c5838621"
    },
    {
      "id": "error-1ef579be",
      "name": "Error Handler",
      "type": "n8n-nodes-base.stopAndError",
      "typeVersion": 1,
      "position": [
        1000,
        400
      ],
      "parameters": {
        "message": "Workflow execution error",
        "options": {}
      }
    }
  ],
  "connections": {},
  "name": "Production Workflow",
  "set...

Output:
This workflow may experience timeout issues with long-running API requests.

**Symptoms**:
- Execution hangs indefinitely
- Connection timeout errors
- ETIMEDOUT or ESOCKETTIMEDOUT errors

**Root Cause**: No timeout configured for HTTP requests, or external services are slow.

**Solutions**:

1. **Set Appropriate Timeouts**:
```json
"options": {
  "timeout": 30000  // 30 seconds
}
```

2. **Add Error Handling**:
- Use Error Trigger node to catch timeout errors
- Implement fallback logic for failed requests

3. **Use Async Patterns**:
- For long operations, use webhook callbacks
- Implement polling patterns instead of waiting

4. **Configure Node Settings**:
```json
"retryOnFail": true,
"maxTries": 3,
"waitBetweenTries": 2000,
"continueOnFail": true
```

**Best Practice**: Set reasonable timeouts (10-30 seconds) and always have error handling for external API calls.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Syntax Error

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "name": "Manualtrigger Workflow:
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        390,
        220
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "4703b399-9233-458a-817a-646055b43c74",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "Unleashed Software",
      "type": "n8n-nodes-base.unleashedSoftware",
      "position": [
        600,
        220
      ],
      "parameters": {
        "filters": {
          "orderStatus": [
            "Completed"
          ]
        },
        "returnAll": true
      },
      "credentials": {
        "unleashedSoftwareApi": "unleashed"
      },
      "typeVersion": 1,
      "id": "66169d59-8672-4487-b17b-1008f7f48144",
      "notes": "This unleashedSoftware node performs automated tasks as part of the workflow."
    },
    {
      "id": "error-da6ec8fc",
      "name": "Error Handler",
      "type": "n8n-nodes-base.stopAndError",
      "typeVersion": 1,
      "position": [
        1000,
        400
      ],
      "parameters": {
        "message": "Workflow execution error",
        "options": {}
      }
    }
  ],
  "active": false,
  "settings": {
    "executionOrder": "v1",
    "saveManualExecutions": true,
    "callerPolicy": "workflowsFromSameOwner",
    "errorWorkflow": null,
    "timezone": "UTC",
    "executionTimeout": 3600,
    "maxExecutions": 1000,
    "retryOnFail": true,
    "retryCount": 3,
    "retryDelay": 1000
  },
  "connections": {},
  "description": "Automated workflow: Manualtrigger Workflow. This workflow processes data and performs automated tasks.",
  "meta": {
    "instanceId": "workflow-aa2e1128",
    "versionId": "1.0.0",
    "createdAt": "2025-09-29T07:07:49.648209",
    "updatedAt": "2025-09-29T07:07:49.648253",
    "owner": "n8n-user",
    "license": "MIT",
    "category": "automation",
    "status": "active",
    "priority"...

Output: The JSON contains an unclosed string. All string values must be enclosed in double quotes.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Rate Limiting Risk

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "id": "64",
  "name": "Upload a file and get a list of all the files in a bucket",
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        390,
        220
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "node-52c54e0d"
    },
    {
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "position": [
        590,
        220
      ],
      "parameters": {
        "url": "{{ $env.BASE_URL }}",
        "options": {},
        "responseFormat": "file"
      },
      "typeVersion": 1,
      "id": "node-f596c7fa"
    },
    {
      "name": "S3",
      "type": "n8n-nodes-base.s3",
      "position": [
        790,
        220
      ],
      "parameters": {
        "fileName": "={{$node[\"HTTP Request\"].binary.data.fileName}}",
        "operation": "upload",
        "bucketName": "n8n",
        "additionalFields": {}
      },
      "credentials": {
        "s3": "s3-n8n"
      },
      "typeVersion": 1,
      "id": "node-3eef3d31"
    },
    {
      "name": "S",
      "type": "n8n-nodes-base.s3",
      "position": [
        990,
        220
      ],
      "parameters": {
        "options": {},
        "operation": "getAll",
        "returnAll": true,
        "bucketName": "n8n"
      },
      "credentials": {
        "s3": "s3-n8n"
      },
      "typeVersion": 1,
      "id": "node-c9af8cf5"
    },
    {
      "id": "error-52021371",
      "name": "Error Handler",
      "type": "n8n-nodes-base.stopAndError",
      "typeVersion": 1,
      "position": [
        1000,
        400
      ],
      "parameters": {
        "message": "Workflow execution error",
        "options": {}
      }
    }
  ],
  "active": false,
  "settings": {
    "executionOrder": "v1",
    "saveManualExecutions": true,
    "callerPolicy": "workflowsFromSameOwner",
    "errorWorkflow": null,
    "timezone": "UTC",
    "executionTimeout": 3600,
    "maxExecutions": 1000,
    "retryO...

Output:
This workflow may encounter rate limiting issues when processing large batches of data.

**Common Rate Limit Errors**:
- HTTP 429 Too Many Requests
- HTTP 503 Service Unavailable
- API-specific rate limit messages

**Root Cause**: The workflow makes too many API requests in a short time period without delays.

**Solutions**:

1. **Add Wait Nodes**: Insert a Wait node between API calls
```json
{
  "parameters": {"amount": 1, "unit": "seconds"},
  "name": "Rate Limit Delay",
  "type": "n8n-nodes-base.wait"
}
```

2. **Enable Retry on Fail**:
```json
"retryOnFail": true,
"maxTries": 3,
"waitBetweenTries": 5000
```

3. **Use Batch Processing**: Split items into smaller batches with delays

4. **Implement Exponential Backoff**: Increase wait times with each retry

**Best Practice**: Always check API documentation for rate limits and implement appropriate throttling.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Data Type Mismatch

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "name": "Store the data received from the CocktailDB API in JSON",
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        250,
        300
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "node-67dcda59"
    },
    {
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "position": [
        400,
        300
      ],
      "parameters": {
        "url": "{{ $env.BASE_URL }}",
        "options": {},
        "_injected_number_field": "not_a_number"
      },
      "typeVersion": 1,
      "id": "node-db49aa27"
    },
    {
      "name": "Move Binary Data",
      "type": "n8n-nodes-base.moveBinaryData",
      "position": [
        550,
        300
      ],
      "parameters": {
        "mode": "jsonToBinary",
        "options": {}
      },
      "typeVersion": 1,
      "id": "node-3826da7a"
    },
    {
      "name": "Write Binary File",
      "type": "n8n-nodes-base.writeBinaryFile",
      "position": [
        700,
        300
      ],
      "parameters": {
        "fileName": "cocktail.json"
      },
      "typeVersion": 1,
      "id": "node-1468bba8"
    },
    {
      "id": "error-6ea82079",
      "name": "Error Handler",
      "type": "n8n-nodes-base.stopAndError",
      "typeVersion": 1,
      "position": [
        1000,
        400
      ],
      "parameters": {
        "message": "Workflow execution error",
        "options": {}
      }
    }
  ],
  "active": false,
  "settings": {
    "executionOrder": "v1",
    "saveManualExecutions": true,
    "callerPolicy": "workflowsFromSameOwner",
    "errorWorkflow": null,
    "timezone": "UTC",
    "executionTimeout": 3600,
    "maxExecutions": 1000,
    "retryOnFail": true,
    "retryCount": 3
  },
  "connections": {},
  "meta": {
    "instanceId": "workflow-c0440313",
    "versionId": "1.0.0",
    "createdAt": "2025-09-29T07:07:49.646843",
    "updatedAt": "2025-09-29T07:07:49.646851",
    "ow...

Output:
The node 'HTTP Request' has a data type mismatch in its parameters.

**Issue**: A field expected a number but received a string value.

**Common Causes**:
1. Expression returns string instead of number
2. JSON parsing preserves string types for numeric values
3. Upstream node outputs different data types than expected

**Solutions**:

1. **Type Conversion in Expression**:
```javascript
// Convert string to number
{ parseInt($json.stringValue) }
{ parseFloat($json.decimalString) }
{ Number($json.value) }
```

2. **Use Code Node for Transformation**:
```javascript
return items.map(item => {
  item.json.numericField = Number(item.json.stringField);
  return item;
});
```

3. **Validate Data Types**:
- Use IF node to check types before processing
- Add error handling for invalid types

**Best Practice**: Always validate and transform data types explicitly when passing data between nodes.

Fix data type conversion in 'HTTP Request'.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Empty Input Handling

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "meta": {
    "instanceId": "workflow-09ade03b",
    "versionId": "1.0.0",
    "createdAt": "2025-09-29T07:07:49.661135",
    "updatedAt": "2025-09-29T07:07:49.661146",
    "owner": "n8n-user",
    "license": "MIT",
    "category": "automation",
    "status": "active",
    "priority": "high",
    "environment": "production"
  },
  "nodes": [
    {
      "id": "f7f8068b-52c9-4038-bd67-9ee50136e4fd",
      "name": "When clicking \u2018Test workflow\u2019",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        380,
        240
      ],
      "parameters": {},
      "typeVersion": 1,
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "id": "860e5e46-a04d-41cb-b91a-c9f02603bcdf",
      "name": "Sample data (name + language)",
      "type": "n8n-nodes-base.code",
      "position": [
        600,
        160
      ],
      "parameters": {
        "jsCode": "return [\n  {\n    json: {\n      name: 'Stefan',\n      language: 'de',\n    }\n  },\n  {\n    json: {\n      name: 'Jim',\n      language: 'en',\n    }\n  },\n  {\n    json: {\n      name: 'Hans',\n      language: 'de',\n    }\n  }\n];"
      },
      "typeVersion": 2,
      "notes": "This code node performs automated tasks as part of the workflow."
    },
    {
      "id": "5c6a867b-fd8a-49b7-ac35-ff84ed6d89f7",
      "name": "Sample data (greeting + language)",
      "type": "n8n-nodes-base.code",
      "position": [
        600,
        320
      ],
      "parameters": {
        "jsCode": "return [\n\t  {\n    json: {\n      greeting: 'Hello',\n      language: 'en',\n    }\n  },\n  {\n    json: {\n      greeting: 'Hallo',\n      language: 'de',\n    }\n  }\n];"
      },
      "typeVersion": 2,
      "notes": "This code node performs automated tasks as part of the workflow."
    },
    {
      "id": "08fca489-8f4c-4327-9919-922bd1be1cd5",
      "name": "Merge (name + language + greeting)",
      "type": "n8n-nodes-base.merge",
      "...

Output:
This workflow may fail when receiving empty or null input data.

**Common Error Messages**:
- "Cannot read property 'x' of undefined"
- "No items to process"
- "Input data is empty"

**Root Cause**: The workflow doesn't handle cases where:
- Trigger receives no data
- Previous node returns empty array
- API returns null or empty response

**Solutions**:

1. **Add IF Node for Empty Check**:
```json
{
  "parameters": {
    "conditions": {
      "number": [{
        "value1": "={{ $json.length }}",
        "operation": "larger",
        "value2": 0
      }]
    }
  },
  "name": "Check Not Empty",
  "type": "n8n-nodes-base.if"
}
```

2. **Use Default Values**:
```javascript
{{ $json.field ?? "default_value" }}
{{ $json.items || [] }}
```

3. **Add Set Node with Defaults**:
- Create a Set node that provides default values
- Place it early in the workflow

4. **Implement No Match Output**:
- Many nodes have "No Match" outputs
- Use these to handle empty cases gracefully

**Best Practice**: Always validate input data and provide sensible defaults for optional fields.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Missing Credentials

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        250,
        350
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "node-f077ce67"
    },
    {
      "name": "FTP",
      "type": "n8n-nodes-base.ftp",
      "position": [
        650,
        350
      ],
      "parameters": {
        "path": "/upload/n8n_logo.png",
        "operation": "upload"
      },
      "credentials": {
        "ftp": "ftp_creds"
      },
      "typeVersion": 1,
      "id": "node-ccc15b17"
    },
    {
      "name": "FTP1",
      "type": "n8n-nodes-base.ftp",
      "position": [
        850,
        350
      ],
      "parameters": {
        "path": "/upload/",
        "operation": "list"
      },
      "typeVersion": 1,
      "id": "node-3384506e"
    },
    {
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "position": [
        450,
        350
      ],
      "parameters": {
        "url": "{{ $env.BASE_URL }}",
        "options": {},
        "responseFormat": "file"
      },
      "typeVersion": 1,
      "id": "node-68428cc9"
    },
    {
      "id": "error-91516a3c",
      "name": "Error Handler",
      "type": "n8n-nodes-base.stopAndError",
      "typeVersion": 1,
      "position": [
        1000,
        400
      ],
      "parameters": {
        "message": "Workflow execution error",
        "options": {}
      }
    }
  ],
  "connections": {},
  "name": "Production Workflow",
  "settings": {
    "executionOrder": "v1",
    "saveManualExecutions": true,
    "callerPolicy": "workflowsFromSameOwner",
    "errorWorkflow": null,
    "timezone": "UTC",
    "executionTimeout": 3600,
    "maxExecutions": 1000,
    "retryOnFail": true,
    "retryCount": 3
  },
  "meta": {
    "instanceId": "workflow-af0e3b32",
    "versionId": "1.0.0",
    "createdAt": "2025-09-29T07:07:49.661627",
    "updatedAt": "2025-09-29T07:07:49.661635",
    "owner": "n8n-user",
    "li...

Output:
The node 'FTP1' (type: n8n-nodes-base.ftp) requires credentials but the 'credentials' configuration is missing.

**Root Cause**: The credentials object was not defined for this node.

**Solution**: Add the credentials configuration back to the node:
```json
"credentials": {
  "ftp": "ftp_creds"
}
```

**Best Practice**: Always verify credentials are properly configured before deploying workflows. Use n8n's credential management system to store sensitive data securely.

Add credentials configuration to the 'FTP1' node.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Timeout Configuration

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        420,
        260
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "7d722d43-7ed2-44dd-9c0a-e85558da9fef",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "Salesforce",
      "type": "n8n-nodes-base.salesforce",
      "position": [
        620,
        260
      ],
      "parameters": {
        "company": "CompanyInc",
        "lastname": "DudeOne",
        "additionalFields": {}
      },
      "credentials": {
        "salesforceOAuth2Api": "salesforce_creds"
      },
      "typeVersion": 1,
      "id": "341ed8e4-00fe-412c-ab1b-7cec45980a29",
      "notes": "This salesforce node performs automated tasks as part of the workflow."
    },
    {
      "name": "Salesforce1",
      "type": "n8n-nodes-base.salesforce",
      "position": [
        810,
        260
      ],
      "parameters": {
        "leadId": "={{$node[\"Salesforce\"].json[\"id\"]}}",
        "operation": "update",
        "updateFields": {
          "city": "Berlin"
        }
      },
      "credentials": {
        "salesforceOAuth2Api": "salesforce_creds"
      },
      "typeVersion": 1,
      "id": "71afc216-a9b3-41d6-b054-5e9295e4171d",
      "notes": "This salesforce node performs automated tasks as part of the workflow."
    },
    {
      "name": "Salesforce2",
      "type": "n8n-nodes-base.salesforce",
      "position": [
        1020,
        260
      ],
      "parameters": {
        "title": "Deal Won!",
        "leadId": "={{$node[\"Salesforce\"].json[\"id\"]}}",
        "options": {},
        "operation": "addNote"
      },
      "credentials": {
        "salesforceOAuth2Api": "salesforce_creds"
      },
      "typeVersion": 1,
      "id": "9f08393c-e1b1-49fe-9d98-47402ebf27f2",
      "notes": "This salesforce node performs automated tasks as part of the workflow."
    },...

Output:
This workflow may experience timeout issues with long-running API requests.

**Symptoms**:
- Execution hangs indefinitely
- Connection timeout errors
- ETIMEDOUT or ESOCKETTIMEDOUT errors

**Root Cause**: No timeout configured for HTTP requests, or external services are slow.

**Solutions**:

1. **Set Appropriate Timeouts**:
```json
"options": {
  "timeout": 30000  // 30 seconds
}
```

2. **Add Error Handling**:
- Use Error Trigger node to catch timeout errors
- Implement fallback logic for failed requests

3. **Use Async Patterns**:
- For long operations, use webhook callbacks
- Implement polling patterns instead of waiting

4. **Configure Node Settings**:
```json
"retryOnFail": true,
"maxTries": 3,
"waitBetweenTries": 2000,
"continueOnFail": true
```

**Best Practice**: Set reasonable timeouts (10-30 seconds) and always have error handling for external API calls.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Empty Input Handling

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        250,
        300
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "node-ad24ae5f"
    },
    {
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "position": [
        440,
        300
      ],
      "parameters": {
        "url": "{{ $env.BASE_URL }}",
        "options": {},
        "responseFormat": "file"
      },
      "typeVersion": 1,
      "id": "node-53c4bf38"
    },
    {
      "name": "LinkedIn",
      "type": "n8n-nodes-base.linkedIn",
      "position": [
        640,
        300
      ],
      "parameters": {
        "text": "this is a test image post",
        "person": "gZG0JALzuy",
        "postAs": "person",
        "additionalFields": {},
        "shareMediaCategory": "IMAGE"
      },
      "credentials": {
        "linkedInOAuth2Api": "linkedin_demo"
      },
      "typeVersion": 1,
      "id": "node-1621ea20"
    },
    {
      "id": "error-e21b894a",
      "name": "Error Handler",
      "type": "n8n-nodes-base.stopAndError",
      "typeVersion": 1,
      "position": [
        1000,
        400
      ],
      "parameters": {
        "message": "Workflow execution error",
        "options": {}
      }
    }
  ],
  "connections": {},
  "name": "Production Workflow",
  "settings": {
    "executionOrder": "v1",
    "saveManualExecutions": true,
    "callerPolicy": "workflowsFromSameOwner",
    "errorWorkflow": null,
    "timezone": "UTC",
    "executionTimeout": 3600,
    "maxExecutions": 1000,
    "retryOnFail": true,
    "retryCount": 3
  },
  "meta": {
    "instanceId": "workflow-78934ad7",
    "versionId": "1.0.0",
    "createdAt": "2025-09-29T07:07:49.668751",
    "updatedAt": "2025-09-29T07:07:49.668769",
    "owner": "n8n-user",
    "license": "MIT",
    "category": "automation",
    "status": "active",
    "priority": "high",
    "environment": "production"
  },
 ...

Output:
This workflow may fail when receiving empty or null input data.

**Common Error Messages**:
- "Cannot read property 'x' of undefined"
- "No items to process"
- "Input data is empty"

**Root Cause**: The workflow doesn't handle cases where:
- Trigger receives no data
- Previous node returns empty array
- API returns null or empty response

**Solutions**:

1. **Add IF Node for Empty Check**:
```json
{
  "parameters": {
    "conditions": {
      "number": [{
        "value1": "={{ $json.length }}",
        "operation": "larger",
        "value2": 0
      }]
    }
  },
  "name": "Check Not Empty",
  "type": "n8n-nodes-base.if"
}
```

2. **Use Default Values**:
```javascript
{{ $json.field ?? "default_value" }}
{{ $json.items || [] }}
```

3. **Add Set Node with Defaults**:
- Create a Set node that provides default values
- Place it early in the workflow

4. **Implement No Match Output**:
- Many nodes have "No Match" outputs
- Use these to handle empty cases gracefully

**Best Practice**: Always validate input data and provide sensible defaults for optional fields.


Instruction:
Debug this n8n workflow. It has the following issue:
Error Type: Timeout Configuration

Please analyze the workflow JSON and explain:
1. What is wrong
2. Why it's causing problems
3. How to fix it

Workflow JSON:
{
  "nodes": [
    {
      "name": "On clicking 'execute'",
      "type": "n8n-nodes-base.manualTrigger",
      "position": [
        0,
        300
      ],
      "parameters": {},
      "typeVersion": 1,
      "id": "e396e64d-ff59-4542-9069-20088e99bd72",
      "notes": "This manualTrigger node performs automated tasks as part of the workflow."
    },
    {
      "name": "Function",
      "type": "n8n-nodes-base.function",
      "position": [
        200,
        300
      ],
      "parameters": {
        "functionCode": "return [\n  {\n    json: {\n      id: 0,\n    }\n  },\n  {\n    json: {\n      id: 1,\n    }\n  },\n  {\n    json: {\n      id: 2,\n    }\n  }\n];\n"
      },
      "typeVersion": 1,
      "id": "316c761f-2449-4b7c-b2e7-4741e459fce7",
      "notes": "This function node performs automated tasks as part of the workflow."
    },
    {
      "name": "Set",
      "type": "n8n-nodes-base.set",
      "position": [
        600,
        90
      ],
      "parameters": {
        "values": {
          "string": [
            {
              "name": "name",
              "value": "n8n"
            }
          ]
        },
        "options": {}
      },
      "typeVersion": 1,
      "id": "1b2e3a63-ce82-42a8-834b-6ae2ef4ebf70",
      "notes": "This set node performs automated tasks as part of the workflow."
    },
    {
      "name": "Set1",
      "type": "n8n-nodes-base.set",
      "position": [
        600,
        230
      ],
      "parameters": {
        "values": {
          "string": [
            {
              "name": "name",
              "value": "nodemation"
            }
          ]
        },
        "options": {}
      },
      "typeVersion": 1,
      "id": "45cb4f75-4e19-4af7-9008-3184ab066642",
      "notes": "This set node performs automated tasks as part of the workflow."
    },
    {
      "name": "Switch",
      "type": "n8n-nodes-base.switch",
      "position": [
        400,
        300
      ],
      "parameters": {
        "rules": {...

Output:
This workflow may experience timeout issues with long-running API requests.

**Symptoms**:
- Execution hangs indefinitely
- Connection timeout errors
- ETIMEDOUT or ESOCKETTIMEDOUT errors

**Root Cause**: No timeout configured for HTTP requests, or external services are slow.

**Solutions**:

1. **Set Appropriate Timeouts**:
```json
"options": {
  "timeout": 30000  // 30 seconds
}
```

2. **Add Error Handling**:
- Use Error Trigger node to catch timeout errors
- Implement fallback logic for failed requests

3. **Use Async Patterns**:
- For long operations, use webhook callbacks
- Implement polling patterns instead of waiting

4. **Configure Node Settings**:
```json
"retryOnFail": true,
"maxTries": 3,
"waitBetweenTries": 2000,
"continueOnFail": true
```

**Best Practice**: Set reasonable timeouts (10-30 seconds) and always have error handling for external API calls.