Skip to content

Streams & Event Types

Events are classified into stream tiers that describe the nature and delivery pattern of the data. Consumers can subscribe by event type or by stream tier (e.g., “all timeseries”).

See Trackers & data coverage for a filterable matrix of which implemented providers deliver each event type.

| Stream | Nature | Delivery Pattern | |--------|--------|-----------------| | session | Bounded activity with start/end | One or more sessions per event | | snapshot | Point-in-time measurement | One or more measurements per event | | timeseries | High-frequency sampled data | Chunked into 15-minute windows | | aggregate | Daily rollup | One summary per event | | profile | Slow-changing user metadata | Sent on connect and on change |

| Event Type | Description | |-----------|-------------| | activity | Tracked workout or exercise session. Google Health can temporarily import this from steps/distance webhooks while exercise webhooks are unreliable. | | sleep | Sleep period with stage breakdown |

| Event Type | Description | |-----------|-------------| | body_measurement | Weight, body composition, anthropometric data | | blood_pressure | Blood pressure reading | | blood_glucose | Blood glucose reading | | blood_work | Lab results with variable analytes | | temperature | Body temperature reading | | nutrition | Food or calorie intake log entry | | hydration | Water intake log entry |

| Event Type | Description | |-----------|-------------| | heart_rate_series | Continuous heart rate samples | | location_series | GPS track data. Google Health can emit this when the temporary exercise fallback fetch resolves TCX GPS samples. | | spo2_series | Oxygen saturation samples | | stress_series | Stress level samples |

| Event Type | Description | |-----------|-------------| | daily_summary | Daily rollup of activity metrics |

| Event Type | Description | |-----------|-------------| | user_profile | Slow-changing user metadata |