Skip to main content

device.connected

The status of a device changed from offline to online. That is, the device.properties.online property changed from false to true. Note that some devices operate entirely in offline mode, so Seam never emits a device.connected event for these devices.
Object (String, Boolean values)
Custom metadata of the connected account, present when connected_account_id is provided.
String (UUID)
required
ID of the connected account associated with the event.
String (ISO 8601)
required
Date and time at which the event was created.
String
The customer key associated with the device, if any.
Object (String, Boolean values)
Custom metadata of the device, present when device_id is provided.
String (UUID)
required
ID of the affected device.
String
Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
String (UUID)
required
ID of the event.
Enum (String)
required
Value: device.connected
String (ISO 8601)
required
Date and time at which the event occurred.
String (UUID)
required
ID of the workspace associated with the event.

device.added

A device was added to Seam or was re-added to Seam after having been removed.
Object (String, Boolean values)
Custom metadata of the connected account, present when connected_account_id is provided.
String (UUID)
required
ID of the connected account associated with the event.
String (ISO 8601)
required
Date and time at which the event was created.
String
The customer key associated with the device, if any.
Object (String, Boolean values)
Custom metadata of the device, present when device_id is provided.
String (UUID)
required
ID of the affected device.
String
Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
String (UUID)
required
ID of the event.
Enum (String)
required
Value: device.added
String (ISO 8601)
required
Date and time at which the event occurred.
String (UUID)
required
ID of the workspace associated with the event.

device.converted_to_unmanaged

A managed device was successfully converted to an unmanaged device.
Object (String, Boolean values)
Custom metadata of the connected account, present when connected_account_id is provided.
String (UUID)
required
ID of the connected account associated with the event.
String (ISO 8601)
required
Date and time at which the event was created.
String
The customer key associated with the device, if any.
Object (String, Boolean values)
Custom metadata of the device, present when device_id is provided.
String (UUID)
required
ID of the affected device.
String
Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
String (UUID)
required
ID of the event.
Enum (String)
required
Value: device.converted_to_unmanaged
String (ISO 8601)
required
Date and time at which the event occurred.
String (UUID)
required
ID of the workspace associated with the event.

device.disconnected

The status of a device changed from online to offline. That is, the device.properties.online property changed from true to false.
Object (String, Boolean values)
Custom metadata of the connected account, present when connected_account_id is provided.
Array of Objects
required
Errors associated with the connected account.
String (UUID)
required
ID of the connected account associated with the event.
Array of Objects
required
Warnings associated with the connected account.
String (ISO 8601)
required
Date and time at which the event was created.
String
The customer key associated with the device, if any.
Object (String, Boolean values)
Custom metadata of the device, present when device_id is provided.
Array of Objects
required
Errors associated with the device.
String (UUID)
required
ID of the affected device.
Array of Objects
required
Warnings associated with the device.
Enum (String)
required
Error code associated with the disconnection event, if any.Possible values: account_disconnected, hub_disconnected, device_disconnected
String
Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
String (UUID)
required
ID of the event.
Enum (String)
required
Value: device.disconnected
String (ISO 8601)
required
Date and time at which the event occurred.
String (UUID)
required
ID of the workspace associated with the event.

device.tampered

A device detected that it was tampered with, for example, opened or moved.
Object (String, Boolean values)
Custom metadata of the connected account, present when connected_account_id is provided.
String (UUID)
required
ID of the connected account associated with the event.
String (ISO 8601)
required
Date and time at which the event was created.
String
The customer key associated with the device, if any.
Object (String, Boolean values)
Custom metadata of the device, present when device_id is provided.
String (UUID)
required
ID of the affected device.
String
Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
String (UUID)
required
ID of the event.
Enum (String)
required
Value: device.tampered
String (ISO 8601)
required
Date and time at which the event occurred.
String (UUID)
required
ID of the workspace associated with the event.

device.low_battery

A device battery level dropped below the low threshold.
Number
Number in the range 0 to 1.0 indicating the battery level of the affected device’s paired accessory keypad, when the device has one and its level is known.
Object (String, Boolean values)
Custom metadata of the connected account, present when connected_account_id is provided.
String (UUID)
required
ID of the connected account associated with the event.
String (ISO 8601)
required
Date and time at which the event was created.
String
The customer key associated with the device, if any.
Number
Number in the range 0 to 1.0 indicating the affected device’s own battery level, when known.
Object (String, Boolean values)
Custom metadata of the device, present when device_id is provided.
String (UUID)
required
ID of the affected device.
String
Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
String (UUID)
required
ID of the event.
Enum (String)
required
Value: device.low_battery
String (ISO 8601)
required
Date and time at which the event occurred.
String (UUID)
required
ID of the workspace associated with the event.

device.battery_status_changed

A device battery status changed since the last battery_status_changed event.
Number
required
Number in the range 0 to 1.0 indicating the amount of battery in the affected device, as reported by the device.
Enum (String)
required
Battery status of the affected device, calculated from the numeric battery_level value.Possible values: critical, low, good, full
Object (String, Boolean values)
Custom metadata of the connected account, present when connected_account_id is provided.
String (UUID)
required
ID of the connected account associated with the event.
String (ISO 8601)
required
Date and time at which the event was created.
String
The customer key associated with the device, if any.
Object (String, Boolean values)
Custom metadata of the device, present when device_id is provided.
String (UUID)
required
ID of the affected device.
String
Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
String (UUID)
required
ID of the event.
Enum (String)
required
Value: device.battery_status_changed
String (ISO 8601)
required
Date and time at which the event occurred.
String (UUID)
required
ID of the workspace associated with the event.

device.removed

A device was removed externally from the connected account.
Object (String, Boolean values)
Custom metadata of the connected account, present when connected_account_id is provided.
String (UUID)
required
ID of the connected account associated with the event.
String (ISO 8601)
required
Date and time at which the event was created.
String
The customer key associated with the device, if any.
Object (String, Boolean values)
Custom metadata of the device, present when device_id is provided.
String (UUID)
required
ID of the affected device.
String
Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
String (UUID)
required
ID of the event.
Enum (String)
required
Value: device.removed
String (ISO 8601)
required
Date and time at which the event occurred.
String (UUID)
required
ID of the workspace associated with the event.

device.deleted

A device was deleted.
Object (String, Boolean values)
Custom metadata of the connected account, present when connected_account_id is provided.
String (UUID)
required
ID of the connected account associated with the event.
String (ISO 8601)
required
Date and time at which the event was created.
String
The customer key associated with the device, if any.
Object (String, Boolean values)
Custom metadata of the device, present when device_id is provided.
String (UUID)
required
ID of the affected device.
String or null
Name of the deleted device, captured at deletion time. The device record no longer exists when this event fires, so the name is preserved here. Null when the device had no resolvable name.
String
Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
String (UUID)
required
ID of the event.
Enum (String)
required
Value: device.deleted
String (ISO 8601)
required
Date and time at which the event occurred.
String (UUID)
required
ID of the workspace associated with the event.

device.third_party_integration_detected

Seam detected that a device is using a third-party integration that will interfere with Seam device management.
Object (String, Boolean values)
Custom metadata of the connected account, present when connected_account_id is provided.
String (UUID)
required
ID of the connected account associated with the event.
String (ISO 8601)
required
Date and time at which the event was created.
String
The customer key associated with the device, if any.
Object (String, Boolean values)
Custom metadata of the device, present when device_id is provided.
String (UUID)
required
ID of the affected device.
String
Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
String (UUID)
required
ID of the event.
Enum (String)
required
Value: device.third_party_integration_detected
String (ISO 8601)
required
Date and time at which the event occurred.
String (UUID)
required
ID of the workspace associated with the event.

device.third_party_integration_no_longer_detected

Seam detected that a device is no longer using a third-party integration that was interfering with Seam device management.
Object (String, Boolean values)
Custom metadata of the connected account, present when connected_account_id is provided.
String (UUID)
required
ID of the connected account associated with the event.
String (ISO 8601)
required
Date and time at which the event was created.
String
The customer key associated with the device, if any.
Object (String, Boolean values)
Custom metadata of the device, present when device_id is provided.
String (UUID)
required
ID of the affected device.
String
Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
String (UUID)
required
ID of the event.
Enum (String)
required
Value: device.third_party_integration_no_longer_detected
String (ISO 8601)
required
Date and time at which the event occurred.
String (UUID)
required
ID of the workspace associated with the event.

device.salto.privacy_mode_activated

A Salto device activated privacy mode.
Object (String, Boolean values)
Custom metadata of the connected account, present when connected_account_id is provided.
String (UUID)
required
ID of the connected account associated with the event.
String (ISO 8601)
required
Date and time at which the event was created.
String
The customer key associated with the device, if any.
Object (String, Boolean values)
Custom metadata of the device, present when device_id is provided.
String (UUID)
required
ID of the affected device.
String
Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
String (UUID)
required
ID of the event.
Enum (String)
required
Value: device.salto.privacy_mode_activated
String (ISO 8601)
required
Date and time at which the event occurred.
String (UUID)
required
ID of the workspace associated with the event.

device.salto.privacy_mode_deactivated

A Salto device deactivated privacy mode.
Object (String, Boolean values)
Custom metadata of the connected account, present when connected_account_id is provided.
String (UUID)
required
ID of the connected account associated with the event.
String (ISO 8601)
required
Date and time at which the event was created.
String
The customer key associated with the device, if any.
Object (String, Boolean values)
Custom metadata of the device, present when device_id is provided.
String (UUID)
required
ID of the affected device.
String
Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
String (UUID)
required
ID of the event.
Enum (String)
required
Value: device.salto.privacy_mode_deactivated
String (ISO 8601)
required
Date and time at which the event occurred.
String (UUID)
required
ID of the workspace associated with the event.

device.connection_became_flaky

Seam detected a flaky device connection.
Object (String, Boolean values)
Custom metadata of the connected account, present when connected_account_id is provided.
Array of Objects
required
Errors associated with the connected account.
String (UUID)
required
ID of the connected account associated with the event.
Array of Objects
required
Warnings associated with the connected account.
String (ISO 8601)
required
Date and time at which the event was created.
String
The customer key associated with the device, if any.
Object (String, Boolean values)
Custom metadata of the device, present when device_id is provided.
Array of Objects
required
Errors associated with the device.
String (UUID)
required
ID of the affected device.
Array of Objects
required
Warnings associated with the device.
String
Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
String (UUID)
required
ID of the event.
Enum (String)
required
Value: device.connection_became_flaky
String (ISO 8601)
required
Date and time at which the event occurred.
String (UUID)
required
ID of the workspace associated with the event.

device.connection_stabilized

Seam detected that a previously-flaky device connection stabilized.
Object (String, Boolean values)
Custom metadata of the connected account, present when connected_account_id is provided.
String (UUID)
required
ID of the connected account associated with the event.
String (ISO 8601)
required
Date and time at which the event was created.
String
The customer key associated with the device, if any.
Object (String, Boolean values)
Custom metadata of the device, present when device_id is provided.
String (UUID)
required
ID of the affected device.
String
Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
String (UUID)
required
ID of the event.
Enum (String)
required
Value: device.connection_stabilized
String (ISO 8601)
required
Date and time at which the event occurred.
String (UUID)
required
ID of the workspace associated with the event.

device.error.subscription_required

A third-party subscription is required to use all device features.
Object (String, Boolean values)
Custom metadata of the connected account, present when connected_account_id is provided.
Array of Objects
required
Errors associated with the connected account.
String (UUID)
required
ID of the connected account associated with the event.
Array of Objects
required
Warnings associated with the connected account.
String (ISO 8601)
required
Date and time at which the event was created.
String
The customer key associated with the device, if any.
Object (String, Boolean values)
Custom metadata of the device, present when device_id is provided.
Array of Objects
required
Errors associated with the device.
String (UUID)
required
ID of the affected device.
Array of Objects
required
Warnings associated with the device.
String
Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
String (UUID)
required
ID of the event.
Enum (String)
required
Value: device.error.subscription_required
String (ISO 8601)
required
Date and time at which the event occurred.
String (UUID)
required
ID of the workspace associated with the event.

device.error.subscription_required.resolved

A third-party subscription is active or no longer required to use all device features.
Object (String, Boolean values)
Custom metadata of the connected account, present when connected_account_id is provided.
String (UUID)
required
ID of the connected account associated with the event.
String (ISO 8601)
required
Date and time at which the event was created.
String
The customer key associated with the device, if any.
Object (String, Boolean values)
Custom metadata of the device, present when device_id is provided.
String (UUID)
required
ID of the affected device.
String
Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
String (UUID)
required
ID of the event.
Enum (String)
required
Value: device.error.subscription_required.resolved
String (ISO 8601)
required
Date and time at which the event occurred.
String (UUID)
required
ID of the workspace associated with the event.

device.accessory_keypad_connected

An accessory keypad was connected to a device.
Object (String, Boolean values)
Custom metadata of the connected account, present when connected_account_id is provided.
String (UUID)
required
ID of the connected account associated with the event.
String (ISO 8601)
required
Date and time at which the event was created.
String
The customer key associated with the device, if any.
Object (String, Boolean values)
Custom metadata of the device, present when device_id is provided.
String (UUID)
required
ID of the affected device.
String
Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
String (UUID)
required
ID of the event.
Enum (String)
required
Value: device.accessory_keypad_connected
String (ISO 8601)
required
Date and time at which the event occurred.
String (UUID)
required
ID of the workspace associated with the event.

device.accessory_keypad_disconnected

An accessory keypad was disconnected from a device.
Object (String, Boolean values)
Custom metadata of the connected account, present when connected_account_id is provided.
Array of Objects
required
Errors associated with the connected account.
String (UUID)
required
ID of the connected account associated with the event.
Array of Objects
required
Warnings associated with the connected account.
String (ISO 8601)
required
Date and time at which the event was created.
String
The customer key associated with the device, if any.
Object (String, Boolean values)
Custom metadata of the device, present when device_id is provided.
Array of Objects
required
Errors associated with the device.
String (UUID)
required
ID of the affected device.
Array of Objects
required
Warnings associated with the device.
String
Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
String (UUID)
required
ID of the event.
Enum (String)
required
Value: device.accessory_keypad_disconnected
String (ISO 8601)
required
Date and time at which the event occurred.
String (UUID)
required
ID of the workspace associated with the event.

device.name_changed

The name of a device was changed.
Object (String, Boolean values)
Custom metadata of the connected account, present when connected_account_id is provided.
String (UUID)
required
ID of the connected account associated with the event.
String (ISO 8601)
required
Date and time at which the event was created.
String
The customer key associated with the device, if any.
Object (String, Boolean values)
Custom metadata of the device, present when device_id is provided.
String (UUID)
required
ID of the affected device.
String
required
The new name of the affected device.
String
Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
String (UUID)
required
ID of the event.
Enum (String)
required
Value: device.name_changed
String (ISO 8601)
required
Date and time at which the event occurred.
String (UUID)
required
ID of the workspace associated with the event.

camera.activated

A camera was activated, for example, by motion detection. For Ring cameras, this event is available only in the Seam Console, not through the API or webhooks.
Object (String, Boolean values)
Custom metadata of the connected account, present when connected_account_id is provided.
String (UUID)
required
ID of the connected account associated with the event.
String (ISO 8601)
required
Date and time at which the event was created.
String
The customer key associated with the device, if any.
Object (String, Boolean values)
Custom metadata of the device, present when device_id is provided.
String (UUID)
required
ID of the affected device.
String
Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
String (UUID)
required
ID of the event.
Enum (String)
required
Value: camera.activated
String
URL to a thumbnail image captured at the time of activation.
Boolean
Whether motion detection activated the camera, if known.
Array of Strings (UUID)
IDs of the media, such as a video clip and a thumbnail image, captured for this activation. Use /media/get to retrieve each one.
Enum (String)
Sub-type of motion detected, if available.Possible values: human, vehicle, package, other
String (ISO 8601)
required
Date and time at which the event occurred.
String
URL to a short video clip captured at the time of activation.
String (UUID)
required
ID of the workspace associated with the event.

device.doorbell_rang

A doorbell button was pressed on a device. For Ring cameras, this event is available only in the Seam Console, not through the API or webhooks.
Object (String, Boolean values)
Custom metadata of the connected account, present when connected_account_id is provided.
String (UUID)
required
ID of the connected account associated with the event.
String (ISO 8601)
required
Date and time at which the event was created.
String
The customer key associated with the device, if any.
Object (String, Boolean values)
Custom metadata of the device, present when device_id is provided.
String (UUID)
required
ID of the affected device.
String
Human-readable description of the event. Persisted when the event is created (so the creating code, including a provider, can supply a tailored description) and otherwise derived from the event.
String (UUID)
required
ID of the event.
Enum (String)
required
Value: device.doorbell_rang
String
URL to a thumbnail image captured at the time the doorbell was pressed.
Array of Strings (UUID)
IDs of the media, such as a video clip and a thumbnail image, captured when the doorbell was pressed. Use /media/get to retrieve each one.
String (ISO 8601)
required
Date and time at which the event occurred.
String
URL to a short video clip captured at the time the doorbell was pressed.
String (UUID)
required
ID of the workspace associated with the event.