global-error-handling

Implement proper error handling patterns for n8n nodes using NodeApiError and NodeOperationError classes. Use this skill when writing try-catch blocks in execute methods, handling HTTP errors, validating parameters, parsing API error responses, implementing continueOnFail logic, writing actionable error messages, or handling errors in trigger nodes. Apply when working with external API calls, authentication errors, rate limiting, or any error scenarios in n8n node development.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

This Claude skill provides comprehensive guidelines for implementing robust error handling in n8n nodes. It leverages specialized classes like NodeApiError and NodeOperationError to manage HTTP failures, validate input parameters, and ensure graceful degradation in automation workflows. By following these standards, developers can create more reliable, user-friendly, and maintainable n8n integrations with improved debugging capabilities.

Use Cases

  • Case 1: Handling external API failures (e.g., 401 Unauthorized, 429 Rate Limit) using NodeApiError to provide actionable feedback to the user.
  • Case 2: Implementing 'continueOnFail' logic to ensure that a single item failure doesn't halt an entire batch processing workflow in n8n.
  • Case 3: Validating node parameters and input formats before execution to prevent runtime crashes and improve the overall user experience.
  • Case 4: Redacting sensitive information from error logs to maintain security and compliance while providing helpful debugging context.
  • Case 5: Crafting user-friendly error messages in trigger nodes to help users quickly identify and fix configuration issues.
nameGlobal Error Handling
descriptionImplement proper error handling patterns for n8n nodes using NodeApiError and NodeOperationError classes. Use this skill when writing try-catch blocks in execute methods, handling HTTP errors, validating parameters, parsing API error responses, implementing continueOnFail logic, writing actionable error messages, or handling errors in trigger nodes. Apply when working with external API calls, authentication errors, rate limiting, or any error scenarios in n8n node development.

When to use this skill:

  • When writing try-catch blocks in n8n node execute methods
  • When handling HTTP request errors (401, 404, 429, etc.)
  • When choosing between NodeApiError and NodeOperationError
  • When validating required parameters and input formats
  • When parsing error responses from external APIs
  • When implementing continueOnFail() logic for batch processing
  • When writing actionable, user-friendly error messages
  • When redacting sensitive information from error output
  • When handling errors in trigger node setup
  • When adding error descriptions that help users fix issues
  • When dealing with authentication, rate limiting, or external service failures

Global Error Handling

This Skill provides Claude Code with specific guidance on how to adhere to coding standards as they relate to how it should handle global error handling.

Instructions

For details, refer to the information provided in this file: global error handling