There are two API keys: a read only key, safe to use in dashboards and shared links, and a read & write key that lets devices post data to your account.

Log in or create an account to get your keys.

No HTTPS on your device? Emoncms also supports AES-128-CBC encrypted posting using your API key as a pre-shared key. See the reference below.

A device key posts data for one node only, so a device that is out in the field never carries your account write key.

The input API accepts a device key in place of an apikey, in the URL or the POST body:

The node the data is posted to must match the nodeid configured for that device, otherwise the post is rejected. Generate a key with device/generatekey.json below.

A template defines a device type and the default inputs, feeds and process lists for it. Template files live in Modules/device/data/*.json.

Setting up a device is two steps: create it with a nodeid and a type, then initialize it to build the inputs and feeds that type expects.

Initialize a device once, on installation. Initializing the same device twice duplicates its inputs and feeds. Use device/template/prepare.json first to see exactly what will be created.

Go to the Devices page