Back to all guides
Connection Issues
Resolve common connectivity and integration problems.
Overview
This guide helps you diagnose and resolve common connection issues with integrations.
Check Integration Status
- Navigate to Integrations → Connected
- Review status indicators (green, yellow, red)
- Click on the integration for details
- Check last successful sync time
Common Issues
Authentication Expired
OAuth tokens can expire. To fix:
- Click "Reconnect" on the integration
- Re-authenticate with admin credentials
- Grant permissions again
Insufficient Permissions
Required permissions may have been revoked:
- Review required permissions in integration docs
- Check admin console for the service
- Re-grant necessary permissions
- Reconnect the integration
API Rate Limits
Provider rate limits may cause sync delays:
- Wait for rate limit window to reset
- Check integration settings for sync frequency
- Consider reducing monitored scope
Network/Firewall Issues
If using IP allowlisting:
- Verify Bleach IP addresses are allowlisted
- Check firewall rules haven't changed
- Test connectivity from your network
Getting Help
If issues persist:
- Collect error messages from integration status
- Note the timestamp of when issues started
- Contact Bleach support with details