Sending Data

Sending Data

A device can send data to TagoIO by using the POST method.

variablestring [max 100 characters]yes
unitstring [max 25 characters]no
valuestring/number/boolean [max 6kB] no
groupstring [max 100 characters]no / auto
locationobject || geoJSONno
metadataobject [max 10kB]no

Learn how to access TagoIO also using Static IP.

You will need to include a Device-Token to authorize the operation. Learn more about the fields necessary to send data to TagoIO, including the Header and other formats.

Variable should NOT contain special characters such as *?!<>.-=$ or space.

Variables will always be converted to lowercase. 

    "variable": "temperature",
    "unit"    : "F",
    "value"   : 55,
    "time"    : "2015-11-03 13:44:33",
    "location": {"lat": 42.2974279, "lng": -85.628292}

Try our Device Emulator to post data and learn the JSON structure.

It’s possible to send more than one register at the same time, using an array. In the example below, the device is sending two registers together.

    "variable": "temperature",
    "unit"    : "F",
    "value"   : 55
}, {
    "variable": "temperature_celsius",
    "unit"    : "C",
    "value"   : 12
The limit of each individual Post is 200 kB (that is about 8,000 registers).


TagoIO uses metadata on variables to change some properties in widgets, but you can also use it to store more information on your variables.

Example of a variable with metadata

  "variable": "temperature",
  "unit": "F",
  "value": 55,
  "metadata": { "color": "red" }

If you send this example and display it in a table, the row containing that value will be red.

Example of a variable with location and metadata

  "variable": "temperature",
  "unit": "F",
  "value": 55,
  "metadata": { "color": "red", "icon": "car" },
    {"lat": 42.2974279, "lng": -85.628292}

If you add this example to a table, the row containing that value will be red, but the icon will be ignored. But if you add it to a Map, the pin containing that location will be red, and its icon will be a car. Learn more about Infobox on Map Widget.

    • Related Articles

    • Sending Data to Device

      TagoIO supports two-way communication with all your devices so that it can send and receive data. There are some options for you to send data from your application to the device. Among the methods, you can use: Publish to MQTT Post data to a ...
    • Deleting Data

      DEL - Headers: Authorization: Your device token. Optional Query Strings KEY TYPE DESCRIPTION query string pre-defined by Tago qty string Maximum number of data to be returned start_date string Start date end_date string end ...
    • Getting Data

      HEADERS: Authorization: Your-Device-Token GET - QUERYSTRINGS: KEY TYPE DESCRIPTION variable string || array Get variables query string pre-defined by Tago qty string Maximum number of data to be returned.  start_date string ...
    • Data Export

      You can download data from your buckets using one of the available formats. Go to the list of Buckets, and click on the 'Export Data' icon located on the top right. Select the format of the file you want to download: CSV XLS JSON XML You can select ...
    • Data Storage

      Data storage is related to the variables stored in the data buckets that are fed by the devices. Each register is composed of a variable and all metadata associated with it. The data storage limit will define the maximum storage capacity for the ...

    Aug 30 - Join us at TagoIO Connect, our annual conference. Learn new features and use cases. Register Here

      Future and past Webinars