# Insert time series values

Endpoint: POST /time-series
Version: v3
Security: oauth2

## Request fields (application/json):

  - `connectorId` (string, required)
    Id of the connector
    Example: "TW-CC-01"

  - `dtId` (string,null)
    Id of the twin

  - `externalId` (string,null)
    External Id of the twin
    Example: "PNTC4Jm8vXy7bWq9rT5sHkLz2p"

  - `sourceTimestamp` (string, required)
    Timestamp when the source recorded the value in ISO 8601 format
    Example: "2024-10-01T12:34:56Z"

  - `scalarValue` (object, required)
    The data value being trended
    Example: 42

  - `properties` (object)
    Properties or metadata about the observation or event being trended.
    Example: {"customerEquipmentId":"X-1234"}


## Response 202 fields

## Response 400 fields