Webhook event types
Every webhook body has the same envelope. Signing is described on Webhooks.
| Type | Sent when |
cli.install_completed | An installation reported install_completed. Once per installation. |
cli.first_run | An installation reported first_run. Once per installation. |
cli.install_started | An installation reported install_started, when you selected that event. Once per installation. Webhooks are the only destination for it. |
test.ping | You chose Send test. data is empty and id starts with clt_test_. |
#Envelope
| Field | Description |
id | Stable event ID, also sent as webhook-id: clt_ and 40 hex characters. |
type | One of the types above. |
timestamp | When the install was recorded, ISO 8601. |
data.website_id | Your website ID. |
data.event_id | The event ID the hook sent. |
data.installation | SHA-256 of a pseudonymous installation ID. Stable across events from one installation. |
data.install_path | The install path ID the install counted toward. |
data.attribution.resolution | matched, ambiguous, unmatched or probable. |
data.attribution.method | receipt, handoff, reconstructed, or null when nothing was found. Installs matched by the network matching of earlier versions say network. |
data.attribution.confidence | high or medium for reconstructed installs, otherwise null. |
data.attribution.policy | The website's attribution policy. |
data.attribution.unattributed_reason | safari or external when nothing matched; see Unattributed installs. Otherwise null. |
data.attribution.signals | Reconstructed installs only: each signal compared, as { signal, points, match, detail }. See Reconstruction. |
data.attribution.touch | The credited visit, or null. |
data.attribution.journey | Every visit found, with the earlier visits its revisits replaced, oldest first. Empty when unmatched. |
#Touch
| Field | Description |
page_url | The page visited, origin and path. |
referrer | The page's referrer, origin and path, or null. |
source_referrer | The external referrer where the session began, or null. |
channel | The channel. |
utm | The session's UTM values, or null. |
visited_at | When the visit was recorded, ISO 8601. |
gpc | true when the visit was made with Global Privacy Control. |
identifiers | Only with Include captured identifiers: { ga4, google_ads, meta, tiktok, x, custom } as captured. |