Overview
IglooHome devices can generate errors and warnings related to device connectivity, bridge status, and access code management. Understanding these codes helps you quickly diagnose and resolve issues.
Note: Error and warning codes may change over time as we improve our error
handling. Use these codes as a reference for troubleshooting, but avoid
building logic that depends on specific code keys remaining static.
Device Errors
Device errors indicate critical issues that prevent normal operation.
| Error Code | Description | Triggered When | Resolution |
|---|
device_disconnected | Device is offline and cannot be reached | Device goes offline (not an offline-only device) | Reconnect the device through the Igloohome app. Check device batteries and network connectivity. |
hub_disconnected | The Igloohome Bridge is offline | Bridge cannot communicate with the cloud | Check bridge power and network connection. Restart the bridge if needed. |
Device Warnings
Device warnings indicate potential issues or configuration limitations but don’t prevent all functionality.
| Warning Code | Description | Triggered When | Impact |
|---|
accessory_keypad_setup_required | Accessory keypad is not linked to the Igloohome Bridge | Device has both keypad and bridge, but they’re not linked | Online access code programming will fail. Link the keypad to the bridge in the Igloohome app. |
hub_required_for_addtional_capabilities | Device is operating without an Igloohome Bridge | Device has no bridge configured | Only offline access codes are available. Add a bridge to enable remote unlock and online access codes. |
device_has_flaky_connection | Device has an unstable internet connection | Frequent network disconnections detected | May experience intermittent issues with remote operations. |
Note: The legacy warning functional_offline_device is being migrated to
hub_required_for_addtional_capabilities.
Access Code Errors
Access code errors prevent the creation or management of access codes.
| Error Code | Description | Triggered When | Resolution |
|---|
igloohome_bridge_too_many_pending_jobs | Bridge queue is at capacity | Bridge has 20 or more pending jobs | Seam will continue retrying automatically. If the issue persists, contact support. Jobs will process as the queue clears. |
igloohome_bridge_offline | Bridge cannot be contacted | Bridge reports that it’s offline or lock is not linked to bridge | Verify the bridge is online and the lock i |
