Connect an external IoT feed

Manual event entry works for low volumes, but cold-chain monitoring and high-throughput lines need data to flow automatically. This guide connects an external feed so device readings land on the event timeline without keystrokes.

1. Generate an API key

Create a workspace API key scoped to event submission. Give it a descriptive name and store the secret securely - it is shown only once.

2. Map device readings to events

Decide which device readings become events. A temperature breach, a gateway scan, or a location ping each map cleanly to a movement or condition event on the timeline.

3. Submit events programmatically

Point your integration at the event API using the key from step 1. Submissions are idempotent when you include the original event reference, so retries never create duplicates.

4. Verify the feed

Open a tracked unit and confirm device events appear alongside manually recorded ones - the platform treats both identically. From here, the timeline stays current with no manual upkeep.