Lock Errors and Warnings

These are Lock-specific errors and warnings. For errors and warnings common to all devices, see Device Errors and Warnings.

Errors

Each error is an object with the following shape:

Example error

{
  "error_code": "salto_ks_subscription_limit_exceeded",
  "message": "Indicates that the Salto site user limit has been reached.",
  "created_at": "2025-01-01T00:00:00.000Z",
  "is_connected_account_error": true,
  "is_device_error": true
}

Error object properties

Enum (String)

Unique identifier of the type of error. Enables quick recognition and categorization of the issue.One of the error codes listed below.

String

Detailed description of the error. Provides insights into the issue and potentially how to rectify it.

String (ISO 8601)

Date and time at which Seam created the error.

Boolean

Indicates that the error is a connected account error.

Boolean

Indicates that the error is not a device error.

`august_lock_not_authorized`

Indicates that the user is not authorized to use the August lock.

`dormakaba_sites_disconnected`

Indicates that one or more dormakaba sites associated with the connected account could not be connected. Contact dormakaba support.

`salto_ks_subscription_limit_exceeded`

Indicates that the Salto site user limit has been reached.

Warnings

Each warning is an object with the following shape:

Example warning

{
  "warning_code": "ttlock_lock_gateway_unlocking_not_enabled",
  "message": "Indicates that the Remote Unlock feature is not enabled in the settings.\"",
  "created_at": "2025-01-01T00:00:00.000Z"
}

Warning object properties

Enum (String)

Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.One of the warning codes listed below.

String

Detailed description of the warning. Provides insights into the issue and potentially how to rectify it.

String (ISO 8601)

Date and time at which Seam created the warning.

`accessory_keypad_setup_required`

Indicates that the accessory keypad exists, but is not linked to the Igloohome Bridge. Online access code programming will fail until the keypad is linked to the Igloohome Bridge in the Igloohome app.

`hub_required_for_additional_capabilities`

Indicates that a hub or relay must be connected to unlock additional capabilities such as remote unlock.

`insufficient_permissions`

Indicates that the connected Kwikset account has member-level access to this lock’s home. Admin or owner access is required to manage access codes and control the lock remotely.

`keynest_unsupported_locker`

Indicates that the key is in a locker that does not support the access codes API.

`lockly_time_zone_not_configured`

Indicates that Seam detected that the Lockly device does not have a time zone configured. Time-bound codes may not work as expected.

`power_saving_mode`

Indicates that the device is in power saving mode and may have limited functionality.

`salto_ks_subscription_limit_almost_reached`

Indicates that the Salto KS site has exceeded 80% of the maximum number of allowed users. Increase your subscription limit or delete some users from your site.

`time_zone_mismatch`

Indicates that the device’s configured time zone does not match its hardware UTC offset. Time-bound access codes may activate at the wrong local time.

`time_zone_unknown`

Indicates that Seam does not know the device’s time zone. Set a time zone to enable time-bound access codes.

`ttlock_lock_gateway_unlocking_not_enabled`

Indicates that the Remote Unlock feature is not enabled in the settings.”

`ttlock_weak_gateway_signal`

Indicates that the gateway signal is weak.

`two_n_device_missing_timezone`

Indicates that the 2N device does not have a time zone configured. Configure a time zone on the device to enable access codes.

`ultraloq_time_zone_unknown`

Indicates that Seam does not know the time zone of the Ultraloq device. Set a time zone to enable time-bound access codes.

`unreliable_online_status`

Indicates that the device may optimistically be reported as online because the provider does not reliably report its online status.

Getting Started

Granting Access

Devices and Systems

Setup

Monitoring

Low-Level APIs

Lock Errors and Warnings

Errors

`august_lock_not_authorized`

`dormakaba_sites_disconnected`

`salto_ks_subscription_limit_exceeded`

Warnings

`accessory_keypad_setup_required`

`hub_required_for_additional_capabilities`

`insufficient_permissions`

`keynest_unsupported_locker`

`lockly_time_zone_not_configured`

`power_saving_mode`

`salto_ks_subscription_limit_almost_reached`

`time_zone_mismatch`

`time_zone_unknown`

`ttlock_lock_gateway_unlocking_not_enabled`

`ttlock_weak_gateway_signal`

`two_n_device_missing_timezone`

`ultraloq_time_zone_unknown`

`unreliable_online_status`

​Errors

​august_lock_not_authorized

​dormakaba_sites_disconnected

​salto_ks_subscription_limit_exceeded

​Warnings

​accessory_keypad_setup_required

​hub_required_for_additional_capabilities

​insufficient_permissions

​keynest_unsupported_locker

​lockly_time_zone_not_configured

​power_saving_mode

​salto_ks_subscription_limit_almost_reached

​time_zone_mismatch

​time_zone_unknown

​ttlock_lock_gateway_unlocking_not_enabled

​ttlock_weak_gateway_signal

​two_n_device_missing_timezone

​ultraloq_time_zone_unknown

​unreliable_online_status

Errors

`august_lock_not_authorized`

`dormakaba_sites_disconnected`

`salto_ks_subscription_limit_exceeded`

Warnings

`accessory_keypad_setup_required`

`hub_required_for_additional_capabilities`

`insufficient_permissions`

`keynest_unsupported_locker`

`lockly_time_zone_not_configured`

`power_saving_mode`

`salto_ks_subscription_limit_almost_reached`

`time_zone_mismatch`

`time_zone_unknown`

`ttlock_lock_gateway_unlocking_not_enabled`

`ttlock_weak_gateway_signal`

`two_n_device_missing_timezone`

`ultraloq_time_zone_unknown`

`unreliable_online_status`