Skip to main content
General guidelines for troubleshooting integration issues across all services.

​
Common Issues

​
Possible Causes

  • Invalid credentials (API key, OAuth token)
  • Expired authentication
  • Incorrect configuration
  • Network connectivity issues

​
Solutions

1

Verify Credentials

Check that credentials are correct and haven’t expired
2

Reconnect

Try disconnecting and reconnecting the integration
3

Check Configuration

Verify all required fields (URLs, IDs, etc.) are correct
4

Test Network

Ensure network connectivity to the external service
For OAuth integrations, try clearing browser cache and cookies before reconnecting.

​
Possible Causes

  • Missing required permissions
  • User revoked access
  • Admin restrictions
  • Resource access limitations

​
Solutions

1

Review Permissions

Check that all required scopes were granted
2

Reconnect with Full Permissions

Disconnect and reconnect, approving all requested permissions
3

Verify Access

Confirm user has access to the specific resources
4

Check Admin Settings

For enterprise accounts, verify admin hasn’t blocked the integration
Some integrations require admin approval. Contact your IT administrator if needed.

​
Possible Causes

  • Too many API requests in short time
  • Concurrent flow executions
  • Bulk operations without throttling
  • Service quota exceeded

​
Solutions

  • Add delays between API calls
  • Use batch operations when available
  • Implement exponential backoff
  • Reduce polling frequency

​
Possible Causes

  • OAuth token expired (shouldn’t happen with auto-refresh)
  • API key rotated
  • Client secret expired
  • Session timeout

​
Solutions

1

Reconnect Integration

Go to Settings → Integrations → Reconnect
2

Update Credentials

For API keys, enter new credentials
3

Check Expiration

For Service Principals, check client secret expiration
4

Test

Run a test flow to verify connection

​
Possible Causes

  • Integration not connected in workspace
  • Wrong workspace selected
  • Integration was disconnected
  • Node requires specific integration

​
Solutions

1

Check Connection

Verify integration is connected: Settings → Integrations
2

Verify Workspace

Ensure you’re in the correct workspace
3

Reconnect

Connect the integration if disconnected
4

Refresh Flow

Refresh the flow editor to see updated integrations

​
Possible Causes

  • Permission issues
  • API changes
  • Filter or query errors
  • Data format mismatches

​
Solutions

  • Verify read/write permissions
  • Check resource-level access
  • Review sharing settings
  • Test with simpler operations

​
Debugging Steps

1

Check Connection Status

Verify integration shows as “Connected” in Settings → Integrations
2

Review Flow Logs

Examine execution logs for error messages and details
3

Test Integration Directly

Create a minimal test flow with just the integration node
4

Verify Permissions

Confirm all required permissions are granted
5

Check External Service

Verify the external service is operational (status pages)
6

Review Recent Changes

Check if credentials were rotated or permissions changed

​
Service-Specific Issues

Common Issues:
IssueSolution
Admin restrictionsContact Google Workspace admin to allow third-party apps
Quota exceededCheck Google API quotas in Cloud Console
Redirect URI mismatchContact Noxus support to verify OAuth configuration
Account not eligibleEnsure using Google Workspace (not personal Gmail)

​
Getting Help

Check Service Status

Verify external service is operational
  • Google Workspace Status
  • Microsoft 365 Status
  • GitHub Status
  • Slack Status

Review Documentation

Check provider-specific guides:

Flow Logs

Examine execution logs for detailed error messages and stack traces

Contact Support

Reach out to Noxus support with:
  • Integration name
  • Error message
  • Flow execution logs
  • Steps to reproduce

​
Best Practices for Reliability

Build resilient flows:
  • Enable “Continue on Error” for integration nodes
  • Add retry logic with exponential backoff
  • Implement fallback paths
  • Log errors for debugging

Authentication Guide

Learn more about authentication methods