User Profile

Stream: profile | Event type: user_profile

Slow-changing user metadata. Sent when a user first connects a provider and whenever the provider reports changes.

Example

{
  "event_type": "user_profile",
  "data_version": "1.1",
  "source_id": "profile-f6g7...",
  "provider_ref": "user-ABCDEF",
  "device_id": null,
  "payload_ts": 1742585400000,
  "revision": 1,
  "capture_mode": null,  "timezone": "Europe/Zurich",
  "date_of_birth": "1990-05-15",
  "biological_sex": "male",
  "height_cm": 178,
  "preferred_units": "metric"
}

Fields

Field	Type	Unit	Description
`timezone`	`string \| null`	IANA timezone	User’s timezone (e.g., `"Europe/Zurich"`).
`date_of_birth`	`string \| null`	ISO 8601 date	Date of birth (e.g., `"1990-05-15"`).
`biological_sex`	`string \| null`	—	Biological sex as reported by provider.
`height_cm`	`number \| null`	cm	Height.
`preferred_units`	`string \| null`	—	User’s preferred unit system.

Biological Sex Values

Value	Description
`"male"`	Male.
`"female"`	Female.
`"other"`	Other or non-binary.
`"unknown"`	Not reported by provider.

Preferred Units Values

Value	Description
`"metric"`	Metric system (kg, cm, km).
`"imperial"`	Imperial system (lbs, in, mi).