Connect a direct MQTT device

A mqtt-direct device connects to our broker itself — no gateway needed.

Protocol: mqtt-direct

Connection fields:

Field Meaning
mqttUsername The device's broker username (issued on creation)
baseTopic Topic prefix your device publishes under

Steps

  1. Add a device with protocol mqtt-direct and define your tags.
  2. On the 201 Created response, copy the username and password shown once — they are not retrievable later.
  3. Configure your device to connect to our MQTT endpoint with those credentials and publish JSON values under its baseTopic.

Publish data to tenants/{tenantId}/devices/{deviceId}/data. Mind your plan's publish-rate limits.

More in Devices
Devices vs. gateways
When you need a gateway, and when a device can talk to us directly.
Device parameters (tags) explained
Tags are the named measurements a device reports — what widgets bind to.
How device online/offline status works
A device is online if we've seen a message in the last 90 seconds.
Alert thresholds (and the yellow dot)
Set a high/low range on a tag; the device dot turns yellow when a reading goes out of range.
Why a device gets suspended
Repeated rate-limit violations suspend a device temporarily — here's the cycle.
Editing, moving, and deleting a device
Change a device's name, connection settings, gateway, or remove it.