---
title: "POST /digitaltwins/{id}/components/{componentPath}/telemetry"
method: POST
path: "/digitaltwins/{id}/components/{componentPath}/telemetry"
tags: ["Twins"]
---

# POST /digitaltwins/{id}/components/{componentPath}/telemetry

`POST /digitaltwins/{id}/components/{componentPath}/telemetry`

Sends telemetry on behalf of a component in a digital twin.
Status codes:
* 204 No Content
* 400 Bad Request
  * InvalidArgument - The digital twin id, message id, or component path is invalid.
  * ValidationFailed - The telemetry content is invalid.
* 404 Not Found
  * DigitalTwinNotFound - The digital twin was not found.
  * ComponentNotFound - The component path was not found.

## Path parameters

- `id` string, required
- `componentPath` string, required

## Query parameters

- `api-version` string, required

## Headers

- `Message-Id` string, required
- `Telemetry-Source-Time` string

## Request body

- object

## Response `204`

Success

## Other responses

- `default` — Default response.

## Changes

- **2026-07-13** (2020-05-31-preview) `6a7b947fa760` — 1 breaking, 2 warning, 1 info
  - added the new required `header` request parameter `dt-id`
  - deleted the `header` request parameter `Message-Id`
  - deleted the `header` request parameter `Telemetry-Source-Time`
  - added the new optional `header` request parameter `dt-timestamp`
- **2026-07-13** (2020-05-31-preview) `d47143e47755` — 1 breaking, 2 warning, 3 info
  - added the new required `header` request parameter `Message-Id`
  - deleted the `header` request parameter `dt-id`
  - deleted the `header` request parameter `dt-timestamp`
  - added the new optional `header` request parameter `traceparent` to all path's operations
  - …2 more

[Change history](https://skmtc.dev/azure/apis/digitaltwins-digitaltwins/changes/digitaltwins/:id/components/:componentPath/telemetry/post.md)

---

[API](https://skmtc.dev/azure/apis/digitaltwins-digitaltwins.md) · [All operations](https://skmtc.dev/azure/apis/digitaltwins-digitaltwins/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/digitaltwins-digitaltwins/revisions/8d81dcdaf9a2/schema)