---
alias: user-guide-iot-event-definition-index
tags:
- data platform
description: "This documentation outlines the structure of IoT event definitions for data ingestion"
---

# IoT Event Definition

:lock: IoTEventDefinition.**Show**

## Overview

**IoT Events** serve as the primary mechanism for ingesting data into Data Platform. For more information, see [[tutorials-eventingestion]].

An **IoT Event Definition** is the entity that represents the structure of an event that can be sent to Data Platform via host APIs. It defines the schema of the event, which is used to validate it before it can be accepted by Data Platform.

Each **IoT Event Definition** is internally represented by a JSON document which is the actual information unit stored and passed between Data Platform components.

## Tying Everything Together

```mermaid
graph LR
    A1[IoT Schema] --- Main[IoT Event Definition] --- A3[Data Set]
    A1[IoT Schema] --- N1[IoT Event Schema Properties]
  
classDef mermaid_title color:#000, fill:#fafafa, stroke:#fafafa, stroke-width:0x, font-size:100%, font-weight:200;
classDef mermaid_start color:#000, fill:#fafafa, stroke:#fafafa, color:#fafafa, stroke-width:0x, font-size:100%, visibility: hidden;
classDef mermaid_businessdata color:#000, fill:#65CDE8, stroke:#65CDE8, stroke-width:0px, font-size:100%;
classDef mermaid_nonbusinessdata color:#000, fill:#B7DEE8, stroke:#B7DEE8, stroke-width:0px, font-size:100%;
classDef mermaid_entity color:#000, fill:#FB9F53, stroke:#FB9F53, stroke-width:0px, font-size:100%;
classDef mermaid_entitylinked color:#000, fill:#FCD5B5, stroke:#FCD5B5, stroke-width:0px, font-size:100%;
classDef mermaid_context color:#000, fill:#B9CDE5, stroke:#B9CDE5, stroke-width:0px, font-size:100%;
classDef mermaid_optional color:#000, fill:#B7DEE8, stroke:#65CDE8, stroke-width:1px, font-size:100%, stroke-dasharray: 5 5;
class Main mermaid_entity
class A1,A2,A3,A4,A5,A6,A7,A8,A9,A10 mermaid_businessdata
class L1,L2,L3,L4,L5,L6 mermaid_entitylinked
class C1,C2,C3,C4,C5,C6 mermaid_context
class N1,N2,N3,N4,N5,N6 mermaid_nonbusinessdata
```