Web Events

What it is

The stream of what happens on your website. One row per event — a page view or a tracked action — with the URL, the session it belongs to, where the visitor came from, the device they used, and a reference to the visitor. It is the raw behavioural layer you use to understand traffic and on-site behaviour.

How it gets data

Populated by marketing agents and connectors (e.g. your analytics/tracking integration); not part of the standard onboarding catalog. Each row carries an external_id dedup key, so re-syncing the same event updates the row instead of duplicating it. Available to query once your workspace runs the relevant agents.

Fields

Field	Type	Description
`external_id`	text	Source event id — the dedup/upsert key
`event_name`	text	The event (e.g. page_view, add_to_cart)
`url`	text	Page URL the event happened on
`session_id`	text	Session the event belongs to
`source`	text	Traffic source / referrer
`device`	text	Device type (e.g. desktop, mobile)
`user_ref`	text	Reference to the visitor, when known
`timestamp_ext`	datetime	When the event happened, as reported by the source

Also carries the system columns id, tenant_id, workspace_id (tenant isolation), created_at, and updated_at. They are managed automatically.

Query it

{
  "method": "tools/call",
  "params": {
    "name": "data_query",
    "arguments": {
      "view_slug": "web_events",
      "filters": { "event_name": "page_view" },
      "select_fields": ["event_name", "url", "session_id", "source", "device", "timestamp_ext"],
      "sort_by": "timestamp_ext",
      "limit": 50
    }
  }
}

Getting Started

Resources

Sales & Commerce

Procurement

Marketing & Outreach

Governance

What it is

How it gets data

Fields

Query it

​What it is

​How it gets data

​Fields

​Query it

What it is

How it gets data

Fields

Query it