IglooHome Error and Warning Codes

This guide covers error and warning codes specific to IglooHome devices integrated through Seam.

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