ThingsBoardInstall

Summary

Saves time series telemetry data to a ThingsBoard entity with an optional Time To Live (TTL).

Inputs

• authentication — Authentication method: API Key or Username/Password.
• entityId (required) — The entity ID (UUID string) to save telemetry for.
• entityType — The entity type (e.g., DEVICE, ASSET). Defaults to DEVICE.
• telemetryJson (required) — Telemetry data in JSON format. Supports simple objects (e.g., {"temperature": 26}), objects with a timestamp (e.g., {"ts": 1634712287000, "values": {"temperature": 26}}), or arrays of timestamped values.
• ttl — Time to live in milliseconds. Only affects Cassandra installations. Set to 0 for no TTL.

Output shape

a success status message

The node returns { status: 'Telemetry with TTL submitted successfully' } upon success. It does not return the saved data.

Examples

Example 1: Save device temperature with a 1-hour TTL

Entity Type: DEVICE, Entity ID: '784f394c-42b6-435a-983c-b7beff2784f9', Telemetry JSON: {"temperature": 26}, TTL: 3600000

Example 2: Save multiple data points with timestamps

Entity Type: DEVICE, Entity ID: 'device-123', Telemetry JSON: [{"ts": 1634712287000, "values": {"voltage": 220}}, {"ts": 1634712290000, "values": {"voltage": 221}}], TTL: 0

Links

• n8n community nodes installation guide