How do I track device counts using webhooks?
Last updated
When managing devices through Seam's API, you may want to maintain an accurate count of devices under management for each connected account. Using webhooks to track device additions and removals is more efficient than polling the API, but it's important to subscribe to the correct events.
Recommended webhook events
To maintain an accurate count of managed devices, subscribe to these four events:
-
device.added— Increment your count -
device.deleted— Decrement your count -
device.converted_to_unmanaged— Decrement your count -
device.unmanaged.converted_to_managed— Increment your count
Avoid using device.connected for counting purposes, as connection status changes don't always correspond to managed device status.
Alternative: polling the API
If you don't need real-time counts or manage a relatively small number of devices per connected account, you can call /devices/list with pagination to get a fresh count on demand. This approach is simpler and avoids potential webhook delivery edge cases.
Need Help?
If you notice missing events, contact Seam support for investigation.