Device Disconnect

Handling Device Disconnect Events

Bouncie devices generate Device Disconnect events when power to the device is removed — typically due to an unplug or tamper incident. These events notify developers that the device has lost external power, either intentionally or unexpectedly.

Why Multiple Disconnect Events Occur

  • Immediate Disconnect (Real-Time Notification): The latest generation of Bouncie devices can transmit an immediate disconnect notification when power is removed, provided that network conditions allow. This enables real-time awareness of unplug or tamper events.

  • Deferred Disconnect (Post-Reconnection Notification): When network connectivity is unavailable at the moment of power loss, the device records the disconnect locally. Once power is restored and the device reconnects to the network, it transmits the stored disconnect event.

Because of this dual-reporting mechanism, developers may observe two Device Disconnect events for a single unplug or tamper incident:

  • One generated immediately when power is lost (if conditions allow)
  • One generated after power restoration and reconnection

Best Practices

  • Treat multiple disconnect events as notifications of the same underlying unplug or tamper event and handle them gracefully within your application.
postWebhookdeviceDisconnect

Payload

eventType'disconnect' required

Event type

imeistring required

IMEI of the device that sent the event

vinstring required

VIN of the vehicle that sent the event

Example payload

{
  "imei": "123456789012345",
  "vin": "1HGBIQOJXMN109186",
  "disconnect": {
    "timestamp": "2026-01-01T08:30:00.000Z",
    "timeZone": "America/Chicago",
    "latitude": 32.7767432,
    "longitude": -96.7970123
  }
}

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.