Skip to main content
WEBHOOK
identity.validated
{
  "id": "evt_01KHEWZ09CQB36JZ5F7D3ZB9NE",
  "type": "<string>",
  "created": 1739571908123,
  "data": {
    "attribution": {
      "type": "website",
      "pixelId": "<string>",
      "sessionId": "<string>",
      "vid": "<string>",
      "prid": "jNNdd"
    },
    "validations": [
      {
        "email": "<string>",
        "validity": "valid",
        "provider": "<string>",
        "error": {
          "code": "<string>",
          "message": "<string>"
        }
      }
    ],
    "session": {
      "pid": "<string>",
      "vid": "<string>",
      "sid": "<string>",
      "tenant": "<string>",
      "createdAt": 123,
      "endedAt": 123,
      "utm": {
        "source": "<string>",
        "medium": "<string>",
        "campaign": "<string>",
        "term": "<string>",
        "content": "<string>"
      },
      "referrer": "<string>",
      "landingPage": "<string>",
      "landingTitle": "<string>",
      "gclid": "<string>",
      "fbclid": "<string>",
      "userAgent": "<string>",
      "screen": {
        "width": 123,
        "height": 123
      },
      "timezone": "<string>",
      "network": {
        "ip": "<string>",
        "country": "<string>",
        "city": "<string>",
        "region": "<string>",
        "regionCode": "<string>",
        "postalCode": "<string>",
        "latitude": "<string>",
        "longitude": "<string>",
        "continent": "<string>",
        "asn": {
          "code": 123,
          "name": "<string>"
        },
        "colo": "<string>",
        "metroCode": "<string>",
        "isEU": true,
        "botManagement": {
          "score": 123,
          "verifiedBot": true,
          "corporateProxy": true,
          "verifiedBotCategory": "<string>"
        }
      },
      "options": {}
    }
  }
}

Headers

​
webhook-id
string
required

Unique identifier for the webhook message

Example:

"evt_01KHEWZ09CQB36JZ5F7D3ZB9NE"

​
webhook-timestamp
string
required

Unix timestamp (seconds) when the webhook was sent

Example:

"1739571908"

​
webhook-signature
string
required

HMAC-SHA256 signature: v1,

Example:

"v1,K3jXN8AQM9LWM0D4loKWxJek..."

Body

application/json
​
id
string
required

Unique event identifier

Example:

"evt_01KHEWZ09CQB36JZ5F7D3ZB9NE"

​
type
string
required

Event type identifier

Allowed value: "identity.validated"
​
created
integer
required

Unix timestamp (milliseconds) when the event was created

Example:

1739571908123

​
data
object
required

Response

Webhook received successfully