Skip to main content
POST
/
events
Record Telemetry Event
curl --request POST \
  --url https://api.example.com/events \
  --header 'Content-Type: application/json' \
  --data '
{
  "event_type": "<string>",
  "wallet_address": "<string>",
  "email": "<string>",
  "installer_tag": "<string>",
  "metadata": {}
}
'
{}

Body

application/json

S33-#73 — body shape for POST /events (top-of-funnel telemetry).

Unauthenticated by design: it must fire before a wallet exists. All string fields are length-capped at the wire boundary so an abusive client cannot bloat the row; metadata is capped by a field validator. event_type is free-text — the known values live in gecko_core.telemetry.store.KNOWN_TELEMETRY_EVENTS, not a Literal.

​
event_type
string
required
Required string length: 1 - 64
​
wallet_address
string | null
Maximum string length: 128
​
email
string | null
Maximum string length: 320
​
installer_tag
string | null
Maximum string length: 128
​
metadata
Metadata · object

Response

Successful Response

​
{key}
boolean