n8n-integration-testing-patterns

name	n8n-integration-testing-patterns
description	API contract testing, authentication flows, rate limit handling, and error scenario coverage for n8n integrations with external services. Use when testing n8n node integrations.
category	n8n-testing
priority	high
tokenEstimate	1100
agents	["n8n-integration-test"]
implementation_status	production
optimization_version	1
last_optimized	"2025-12-15T00:00:00.000Z"
dependencies	[]
quick_reference_card	true
tags	["n8n","integration","api","authentication","oauth","rate-limiting","testing"]
trust_tier	3
validation	{"schema_path":"schemas/output.json","validator_path":"scripts/validate-config.json","eval_path":"evals/n8n-integration-testing-patterns.yaml"}

n8n Integration Testing Patterns

<default_to_action> When testing n8n integrations:

1. VERIFY connectivity and authentication
2. TEST all configured operations
3. VALIDATE API response handling
4. CHECK rate limit behavior
5. CONFIRM error handling works

Quick Integration Checklist:

• Credentials valid and not expired
• API permissions sufficient for operations
• Rate limits understood and respected
• Error responses properly handled
• Data formats match API expectations

Critical Success Factors:

• Test in isolation before workflow integration
• Verify OAuth token refresh works
• Check API version compatibility
• Monitor rate limit headers </default_to_action>

Quick Reference Card

Common n8n Integrations

Category	Services	Auth Type
Communication	Slack, Teams, Discord	OAuth2, Webhook
Data Storage	Google Sheets, Airtable	OAuth2, API Key
CRM	Salesforce, HubSpot	OAuth2
Dev Tools	GitHub, Jira, Linear	OAuth2, API Key
Marketing	Mailchimp, SendGrid	API Key

Authentication Types

Type	Setup	Refresh
OAuth2	User authorization flow	Automatic token refresh
API Key	Manual key entry	Manual rotation
Basic Auth	Username/password	No refresh needed
Header Auth	Custom header	Manual rotation

---

Connectivity Testing

// Test integration connectivity
async  (): <> {
   node =  (nodeName);

  
   (!node.) {
     { : , :  };
  }

  
   ((node.)) {
     :
        (node.);
     :
        (node.);
     :
        (node.);
     :
        (node.);
    :
        (node);
  }
}


  (): <> {
   {
     response =  (, {
      : { :  }
    });
     data =  response.();

     {
      : data.,
      : data.,
      : data.,
      : data.?. || []
    };
  }  (error) {
     { : , : error. };
  }
}


  (): <> {
   {
     response =  (, {
      : { :  }
    });

     (response. === ) {
      
       refreshed =  (credentials);
       (refreshed) {
         ({ ...credentials, : refreshed });
      }
       { : , :  };
    }

     data =  response.();
     { : , : data. };
  }  (error) {
     { : , : error. };
  }
}