---
title: "Send Data"
method: POST
path: "/data"
tags: ["Device Data"]
---

# Send Data

`POST /data`

## Request

- Base URL: `https://api.us-e1.tago.io`
- URL: `https://api.us-e1.tago.io/data`
- Auth: API key in header `Device-Token`
- TypeScript: <https://skmtc.dev/tago/apis/tagoio-api/docs/data/post.ts> (a function with typed inputs; its response is checked against the schema)

Send Device Data

## Request body

- union: Accepts a single item or an array of items when sent as application/json. For text/plain content, use the [Payload Parser](/docs/tagoio/devices/payload-parser/) to normalize the data into TagoIO JSON format.
  - DeviceDataItem
    - `variable` string, required
    - `location` object
      - `lat` number
      - `lng` number
    - `value` string
    - `time` string: ISO 8601 string or Unix timestamp
    - `group` string: Unique grouping ID for your data. Widgets often group by this.
    - `unit` string: Provide a unit of measurement to the data. Most widgets will display the unit.
    - `metadata` object: Can be attached to the data to influence widget behavior and store additional information.
  - DeviceDataItem[]: Accepts a single item or an array of items.
    - `variable` string, required
    - `location` object
      - `lat` number
      - `lng` number
    - `value` string
    - `time` string: ISO 8601 string or Unix timestamp
    - `group` string: Unique grouping ID for your data. Widgets often group by this.
    - `unit` string: Provide a unit of measurement to the data. Most widgets will display the unit.
    - `metadata` object: Can be attached to the data to influence widget behavior and store additional information.

## Response `200`

Sending data

- object
  - `result` string
  - `status` boolean

---

[API](https://skmtc.dev/tago/apis/tagoio-api.md) - [All operations](https://skmtc.dev/tago/apis/tagoio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tago/apis/tagoio-api/revisions/1a281f04cdab?raw)