Webhook Events Reference
Complete payload reference for all visitor identification webhook events. Select an event type to view its full schema.
Event-Specific Fields
identity.resolved fires the moment a visitor is first recognized. Contains basic identity data (emails, demographics, location, professional info) plus attribution and session context.
API ReferenceRoot
/| Field | Type | Description | Example |
|---|---|---|---|
| id | string | Unique event identifier (ULID) | evt_01KH5FW03RQB28JZ4F9D2ZC8ME |
| type | string | Event type | identity.resolved |
| created | timestamp | Event creation time (ms epoch) | 1739571908123 |
Attribution
data.attribution| Field | Type | Description | Example |
|---|---|---|---|
| type | string | Attribution source type | website |
| pixelId | string | Tracking pixel identifier | mdb_pxl_01KGR7E2S9JK6813H42SCG3QLP |
| sessionId | string | Session identifier (ULID) | 01KH5FW03R8XCZQ7PCYNV4ND1H |
| vid | string | Visitor identifier (ULID) | 01KH5FW03RXBE3EZGHKW8V1J7M |
| prid | string | Provider resolution ID | jNNdd |
Identity — Emails
data.identity.emails[]Unique| Field | Type | Description | Example |
|---|---|---|---|
| value | string | Email address | peter@midbound.ai |
| type | string | Email type | personal | professional |
Identity — Contact
data.identityUnique| Field | Type | Description | Example |
|---|---|---|---|
| linkedinUrl | stringnullable | LinkedIn profile URL | linkedin.com/in/ptrtht |
| phones[] | string[] | Phone numbers (can be empty) | ["+351913168884"] | [] |
Identity — Demographics
data.identity.demographicsUnique| Field | Type | Description | Example |
|---|---|---|---|
| firstName | stringnullable | First name | Peter |
| lastName | stringnullable | Last name | Toth |
| isHomeowner | booleannullable | Homeownership status | true | null |
| hasChildren | booleannullable | Has children | true | null |
| isMarried | booleannullable | Marital status | false | null |
Identity — Location
data.identity.locationUnique| Field | Type | Description | Example |
|---|---|---|---|
| city | stringnullable | City | Lisbon |
| state | stringnullable | State / Province code | null |
| country | stringnullable | Country (ISO alpha-2) | PT |
Identity — Professional
data.identity.professionalUnique| Field | Type | Description | Example |
|---|---|---|---|
| jobTitle | stringnullable | Job title | Co-Founder & CTO |
| companyName | stringnullable | Company name | Midbound |
Shared Session Fields
Session — Core
data.sessionShared| Field | Type | Description | Example |
|---|---|---|---|
| pid | string | Pixel ID | mdb_pxl_01KGR7E2S9JK6813H42SCG3QLP |
| vid | string | Visitor ID | 01KH5FW03RXBE3EZGHKW8V1J7M |
| sid | string | Session ID | 01KH5FW03R8XCZQ7PCYNV4ND1H |
| tenant | stringnullable | Tenant / workspace identifier | cmf2oge8k0002s7018bi6snpf | null |
| createdAt | timestamp | Session start time (ms epoch) | 1739571906432 |
| endedAt | timestampnullable | Session end time (null if active) | 1739572108955 | null |
| referrer | stringnullable | Referrer URL | https://www.google.com/ | null |
| landingPage | string | Landing page URL | https://example.com/pricing/ |
| landingTitle | stringnullable | Landing page title | Pricing Plans | Example Inc |
| gclid | stringnullable | Google Click ID | CjwKCAjw9pGjBhB... | null |
| fbclid | stringnullable | Facebook Click ID | IwY2XjEwNjlmYTh... | null |
| userAgent | string | Browser user agent | Mozilla/5.0 (Macintosh; Intel ... |
| timezone | string | Visitor timezone (IANA) | Europe/Lisbon |
| options | object | Additional session options | {} |
Session — UTM
data.session.utmShared| Field | Type | Description | Example |
|---|---|---|---|
| source | stringnullable | UTM source | google | null |
| medium | stringnullable | UTM medium | cpc | null |
| campaign | stringnullable | UTM campaign | q1_brand_awareness | null |
| term | stringnullable | UTM term | visitor+identification | null |
| content | stringnullable | UTM content | banner_v2 | null |
Session — Screen
data.session.screenShared| Field | Type | Description | Example |
|---|---|---|---|
| width | number | Screen width (px) | 1920 |
| height | number | Screen height (px) | 1080 |
Session — Network
data.session.networkShared| Field | Type | Description | Example |
|---|---|---|---|
| ip | stringnullable | IP address | 89.154.32.71 |
| country | stringnullable | Country (ISO alpha-2) | PT |
| city | stringnullable | City (geo-IP) | Lisbon |
| region | stringnullable | Region / state name | Lisbon |
| regionCode | stringnullable | Region code | 11 |
| postalCode | stringnullable | Postal / ZIP code | 1100 |
| latitude | stringnullable | Latitude | 38.7223 |
| longitude | stringnullable | Longitude | -9.1393 |
| continent | stringnullable | Continent code | EU |
| colo | stringnullable | Cloudflare data center (IATA) | LIS |
| metroCode | stringnullable | Nielsen DMA code | null |
| isEU | booleannullable | EU visitor | true |
Network — ASN
data.session.network.asnShared| Field | Type | Description | Example |
|---|---|---|---|
| code | numbernullable | Autonomous System Number | 3243 |
| name | stringnullable | AS / ISP name | MEO - Servicos de Comunicacoes |
Network — Bot Management
data.session.network.botManagementShared| Field | Type | Description | Example |
|---|---|---|---|
| score | numbernullable | Bot score (1–99, higher = human) | 85 | null |
| verifiedBot | booleannullable | Known verified bot | true | null |
| corporateProxy | booleannullable | Corporate proxy | false | null |
| verifiedBotCategory | stringnullable | Bot classification | Search Engine Crawler | null |