Overview
This article catalogs the error messages the Philips Hue integration can write to the iPaaS.com error logs, grouped by flow. Because Philips Hue is a command-based integration that sends light commands rather than importing data, almost all errors relate to authentication and connection. You can find these entries under Dashboard / Integration Monitoring / Error Logs.
One common behavior is not an error: if a light command's custom field name does not match a light or group on your Hue Bridge, the command is skipped silently — nothing is written to the error logs. See Philips Hue Known Limitations and the Philips Hue Light Command mapping documentation for that behavior.
Supported Flows
Authentication and Connection
Authentication and Connection
Connection not established
Device does not have a refresh token on file. An initial connection must be re-established.
Description: The subscription has not been authenticated to Philips Hue yet, or its stored connection was cleared, so there is no token to renew.
Resolution: Open the Philips Hue subscription settings and click Authenticate to establish the connection. See Philips Hue Connections and Settings.
Expired connection
Refresh Token is expired. An initial connection must be re-established.
Description: The Philips Hue connection expired — usually after a long period without use — so it can no longer be renewed automatically.
Resolution: Re-authenticate the subscription using the Authenticate button to restore the connection.
Philips Hue rejected the request
Hue response - ErrorCode: {ErrorCode} Error: {Error}
Description: Philips Hue rejected the request to obtain or renew a token. The specific code and message come from Philips Hue.
Resolution: Re-authenticate the subscription. If the error continues, contact iPaaS.com Support at support@ipaas.com.
Authorization could not be completed
Unable to complete the Philips Hue authorization. The temporary authorization code could not be exchanged for a lasting connection.
Description: The sign-in with Philips Hue started but could not be completed, so no lasting connection was created.
Resolution: Try the Authenticate step again. If it keeps failing, contact iPaaS.com Support at support@ipaas.com.