---
title: "Send Device Data"
method: POST
path: "/device/{deviceID}/data"
tags: ["Devices"]
---

# Send Device Data

`POST /device/{deviceID}/data`

## Request

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

Send data to a specific Device within your profile

## 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)