Common Error Messages

Common Error Messages

Here are some common error messages you might encounter in Staykey and how to resolve them:

Connection Errors

"Cannot connect to Home Assistant":

• Verify your Home Assistant URL is correct and accessible
• Check that your Home Assistant instance is running
• Ensure your network allows connections between Staykey and Home Assistant
• Verify your API token is valid and has proper permissions

"Device not found":

• The device may have been removed from Home Assistant
• Try refreshing your device list in Staykey
• Re-add the device if it was removed

Device Errors

"Device not responding":

• Check device power and battery level
• Verify device is within range of your Z-Wave hub
• Try re-interviewing the device in Home Assistant

"Failed to set access code":

• Lock may have reached its code limit
• Verify code format meets lock requirements
• Check that the lock supports user code management

"Device offline":

• Check device power and connectivity
• Verify Z-Wave network is functioning
• Try moving device closer to hub

Access Code Errors

"Code limit reached":

• Your lock has a maximum number of user codes
• Remove old or unused codes
• Consider upgrading to a lock with more code slots

"Invalid code format":

• Verify code meets your lock's requirements (length, characters)
• Most locks require 4-8 digit numeric codes

Calendar Sync Errors

"Calendar sync failed":

• Verify your iCal URL is accessible
• Check calendar feed format is correct
• Ensure authentication credentials are valid (if required)

"Unable to parse booking":

• Email format may not be recognized
• Contact support with the email format for assistance

Getting More Help

If you encounter an error not listed here, or if these solutions don't resolve your issue, please contact our support team with:

• The exact error message
• When the error occurred
• What you were trying to do
• Any troubleshooting steps you've already tried