openapi: 3.1.0
info:
  title: Midbound Cloud API
  description: Public-facing Admin API for Midbound Cloud services.
  version: 1.0.0
  contact:
    name: Midbound
    url: https://midbound.cloud
components:
  schemas: {}
paths:
  /health:
    get:
      summary: Health check
      tags:
        - health
      description: Returns the current health status of the API
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - ok
                      - degraded
                      - unhealthy
                    description: Service health status
                  version:
                    type: string
                    description: API version
                  timestamp:
                    type: string
                    format: date-time
                    description: Current server timestamp (ISO)
                required:
                  - status
                  - version
                  - timestamp
                additionalProperties: false
      x-codeSamples:
        - lang: JavaScript
          source: |-
            import MidboundCloud from '@midbound/cloud';

            const client = new MidboundCloud({
              apiKey: process.env['MIDBOUND_CLOUD_API_KEY'], // This is the default and can be omitted
            });

            const response = await client.health.check();

            console.log(response.status);
        - lang: Python
          source: |-
            import os
            from midbound_cloud import MidboundCloud

            client = MidboundCloud(
                api_key=os.environ.get("MIDBOUND_CLOUD_API_KEY"),  # This is the default and can be omitted
            )
            response = client.health.check()
            print(response.status)
        - lang: Go
          source: "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/Midbound/cloud-sdk-go\"\n\t\"github.com/Midbound/cloud-sdk-go/option\"\n)\n\nfunc main() {\n\tclient := midboundcloud.NewClient(\n\t\toption.WithAPIKey(\"My API Key\"),\n\t)\n\tresponse, err := client.Health.Check(context.TODO())\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", response.Status)\n}\n"
servers:
  - url: https://api.midbound.cloud
    description: Production
tags:
  - name: health
    description: Health check endpoints
  - name: webhooks
    description: Webhook event callbacks sent to your endpoints
webhooks:
  identity.resolved:
    post:
      summary: Identity Resolved
      description: >-
        Fired the moment a visitor is recognized by the system. Optimized for
        maximum speed, provides the core unique identifier and basic session
        metadata. Best used for immediate on-site personalization where
        millisecond-level latency is critical.
      operationId: webhook_identity_resolved
      tags:
        - webhooks
      parameters:
        - name: webhook-id
          in: header
          required: true
          description: Unique identifier for the webhook message
          schema:
            type: string
            example: evt_01KHEWZ09CQB36JZ5F7D3ZB9NE
        - name: webhook-timestamp
          in: header
          required: true
          description: Unix timestamp (seconds) when the webhook was sent
          schema:
            type: string
            example: '1739571908'
        - name: webhook-signature
          in: header
          required: true
          description: 'HMAC-SHA256 signature: v1,<base64-signature>'
          schema:
            type: string
            example: v1,K3jXN8AQM9LWM0D4loKWxJek...
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - id
                - type
                - created
                - data
              properties:
                id:
                  type: string
                  description: Unique event identifier
                  example: evt_01KHEWZ09CQB36JZ5F7D3ZB9NE
                type:
                  type: string
                  const: identity.resolved
                  description: Event type identifier
                created:
                  type: integer
                  description: Unix timestamp (milliseconds) when the event was created
                  example: 1739571908123
                data:
                  type: object
                  properties:
                    attribution:
                      type: object
                      properties:
                        type:
                          type: string
                          enum:
                            - website
                        pixelId:
                          type: string
                        sessionId:
                          type: string
                        vid:
                          type: string
                        prid:
                          type: string
                          enum:
                            - jNNdd
                            - OMzN4
                      required:
                        - type
                        - pixelId
                        - sessionId
                        - vid
                        - prid
                      additionalProperties: false
                    identity:
                      type: object
                      properties:
                        emails:
                          type: array
                          items:
                            type: object
                            properties:
                              value:
                                type: string
                              type:
                                type: string
                                enum:
                                  - personal
                                  - professional
                            required:
                              - value
                              - type
                            additionalProperties: false
                        linkedinUrl:
                          type: string
                          nullable: true
                        phones:
                          type: array
                          items:
                            type: string
                        demographics:
                          type: object
                          properties:
                            firstName:
                              type: string
                              nullable: true
                            lastName:
                              type: string
                              nullable: true
                            isHomeowner:
                              type: boolean
                              nullable: true
                            hasChildren:
                              type: boolean
                              nullable: true
                            isMarried:
                              type: boolean
                              nullable: true
                          required:
                            - firstName
                            - lastName
                            - isHomeowner
                            - hasChildren
                            - isMarried
                          additionalProperties: false
                        location:
                          type: object
                          properties:
                            city:
                              type: string
                              nullable: true
                            state:
                              type: string
                              nullable: true
                            country:
                              type: string
                              nullable: true
                          required:
                            - city
                            - state
                            - country
                          additionalProperties: false
                        professional:
                          type: object
                          properties:
                            jobTitle:
                              type: string
                              nullable: true
                            companyName:
                              type: string
                              nullable: true
                          required:
                            - jobTitle
                            - companyName
                          additionalProperties: false
                      required:
                        - emails
                        - linkedinUrl
                        - phones
                        - demographics
                        - location
                        - professional
                      additionalProperties: false
                    session:
                      type: object
                      properties:
                        pid:
                          type: string
                        vid:
                          type: string
                        sid:
                          type: string
                        tenant:
                          type: string
                          nullable: true
                        createdAt:
                          type: number
                        endedAt:
                          type: number
                          nullable: true
                        utm:
                          type: object
                          properties:
                            source:
                              type: string
                              nullable: true
                            medium:
                              type: string
                              nullable: true
                            campaign:
                              type: string
                              nullable: true
                            term:
                              type: string
                              nullable: true
                            content:
                              type: string
                              nullable: true
                          required:
                            - source
                            - medium
                            - campaign
                            - term
                            - content
                          additionalProperties: false
                        referrer:
                          type: string
                          nullable: true
                        landingPage:
                          type: string
                        landingTitle:
                          type: string
                          nullable: true
                        gclid:
                          type: string
                          nullable: true
                        fbclid:
                          type: string
                          nullable: true
                        userAgent:
                          type: string
                        screen:
                          type: object
                          properties:
                            width:
                              type: number
                            height:
                              type: number
                          required:
                            - width
                            - height
                          additionalProperties: false
                        timezone:
                          type: string
                        network:
                          type: object
                          properties:
                            ip:
                              type: string
                              nullable: true
                            country:
                              type: string
                              nullable: true
                            city:
                              type: string
                              nullable: true
                            region:
                              type: string
                              nullable: true
                            regionCode:
                              type: string
                              nullable: true
                            postalCode:
                              type: string
                              nullable: true
                            latitude:
                              type: string
                              nullable: true
                            longitude:
                              type: string
                              nullable: true
                            continent:
                              type: string
                              nullable: true
                            asn:
                              type: object
                              properties:
                                code:
                                  type: number
                                  nullable: true
                                name:
                                  type: string
                                  nullable: true
                              required:
                                - code
                                - name
                              additionalProperties: false
                            colo:
                              type: string
                              nullable: true
                            metroCode:
                              type: string
                              nullable: true
                            isEU:
                              type: boolean
                              nullable: true
                            botManagement:
                              type: object
                              properties:
                                score:
                                  type: number
                                  nullable: true
                                verifiedBot:
                                  type: boolean
                                  nullable: true
                                corporateProxy:
                                  type: boolean
                                  nullable: true
                                verifiedBotCategory:
                                  type: string
                                  nullable: true
                              required:
                                - score
                                - verifiedBot
                                - corporateProxy
                                - verifiedBotCategory
                              additionalProperties: false
                          required:
                            - ip
                            - country
                            - city
                            - region
                            - regionCode
                            - postalCode
                            - latitude
                            - longitude
                            - continent
                            - asn
                            - colo
                            - metroCode
                            - isEU
                            - botManagement
                          additionalProperties: false
                        options:
                          type: object
                          additionalProperties: {}
                          default: {}
                      required:
                        - pid
                        - vid
                        - sid
                        - tenant
                        - createdAt
                        - endedAt
                        - utm
                        - referrer
                        - landingPage
                        - landingTitle
                        - gclid
                        - fbclid
                        - userAgent
                        - screen
                        - timezone
                        - network
                      additionalProperties: false
                      nullable: true
                  required:
                    - attribution
                    - identity
                    - session
                  additionalProperties: false
      responses:
        '200':
          description: Webhook received successfully
        4XX:
          description: Client error - webhook will be retried
        5XX:
          description: Server error - webhook will be retried
  identity.qualified:
    post:
      summary: Identity Qualified
      description: >-
        Fired once the identity is verified with professional-grade data points.
        Guarantees delivery of essential attributes such as LinkedIn profiles,
        current job titles, and primary company information. Recommended trigger
        for sales alerts and lead routing.
      operationId: webhook_identity_qualified
      tags:
        - webhooks
      parameters:
        - name: webhook-id
          in: header
          required: true
          description: Unique identifier for the webhook message
          schema:
            type: string
            example: evt_01KHEWZ09CQB36JZ5F7D3ZB9NE
        - name: webhook-timestamp
          in: header
          required: true
          description: Unix timestamp (seconds) when the webhook was sent
          schema:
            type: string
            example: '1739571908'
        - name: webhook-signature
          in: header
          required: true
          description: 'HMAC-SHA256 signature: v1,<base64-signature>'
          schema:
            type: string
            example: v1,K3jXN8AQM9LWM0D4loKWxJek...
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - id
                - type
                - created
                - data
              properties:
                id:
                  type: string
                  description: Unique event identifier
                  example: evt_01KHEWZ09CQB36JZ5F7D3ZB9NE
                type:
                  type: string
                  const: identity.qualified
                  description: Event type identifier
                created:
                  type: integer
                  description: Unix timestamp (milliseconds) when the event was created
                  example: 1739571908123
                data:
                  type: object
                  properties:
                    attribution:
                      type: object
                      properties:
                        type:
                          type: string
                          enum:
                            - website
                        pixelId:
                          type: string
                        sessionId:
                          type: string
                        vid:
                          type: string
                        prid:
                          type: string
                          enum:
                            - jNNdd
                            - OMzN4
                      required:
                        - type
                        - pixelId
                        - sessionId
                        - vid
                        - prid
                      additionalProperties: false
                    identity:
                      type: object
                      properties:
                        emails:
                          type: array
                          items:
                            type: object
                            properties:
                              value:
                                type: string
                              type:
                                type: string
                                enum:
                                  - personal
                                  - professional
                            required:
                              - value
                              - type
                            additionalProperties: false
                        linkedinUrl:
                          type: string
                        phones:
                          type: array
                          items:
                            type: string
                        demographics:
                          type: object
                          properties:
                            firstName:
                              type: string
                              nullable: true
                            lastName:
                              type: string
                              nullable: true
                            isHomeowner:
                              type: boolean
                              nullable: true
                            hasChildren:
                              type: boolean
                              nullable: true
                            isMarried:
                              type: boolean
                              nullable: true
                          required:
                            - firstName
                            - lastName
                            - isHomeowner
                            - hasChildren
                            - isMarried
                          additionalProperties: false
                        location:
                          type: object
                          properties:
                            city:
                              type: string
                              nullable: true
                            state:
                              type: string
                              nullable: true
                            country:
                              type: string
                              nullable: true
                          required:
                            - city
                            - state
                            - country
                          additionalProperties: false
                        professional:
                          type: object
                          properties:
                            jobTitle:
                              type: string
                              nullable: true
                            companyName:
                              type: string
                              nullable: true
                          required:
                            - jobTitle
                            - companyName
                          additionalProperties: false
                      required:
                        - emails
                        - linkedinUrl
                        - phones
                        - demographics
                        - location
                        - professional
                      additionalProperties: false
                    session:
                      type: object
                      properties:
                        pid:
                          type: string
                        vid:
                          type: string
                        sid:
                          type: string
                        tenant:
                          type: string
                          nullable: true
                        createdAt:
                          type: number
                        endedAt:
                          type: number
                          nullable: true
                        utm:
                          type: object
                          properties:
                            source:
                              type: string
                              nullable: true
                            medium:
                              type: string
                              nullable: true
                            campaign:
                              type: string
                              nullable: true
                            term:
                              type: string
                              nullable: true
                            content:
                              type: string
                              nullable: true
                          required:
                            - source
                            - medium
                            - campaign
                            - term
                            - content
                          additionalProperties: false
                        referrer:
                          type: string
                          nullable: true
                        landingPage:
                          type: string
                        landingTitle:
                          type: string
                          nullable: true
                        gclid:
                          type: string
                          nullable: true
                        fbclid:
                          type: string
                          nullable: true
                        userAgent:
                          type: string
                        screen:
                          type: object
                          properties:
                            width:
                              type: number
                            height:
                              type: number
                          required:
                            - width
                            - height
                          additionalProperties: false
                        timezone:
                          type: string
                        network:
                          type: object
                          properties:
                            ip:
                              type: string
                              nullable: true
                            country:
                              type: string
                              nullable: true
                            city:
                              type: string
                              nullable: true
                            region:
                              type: string
                              nullable: true
                            regionCode:
                              type: string
                              nullable: true
                            postalCode:
                              type: string
                              nullable: true
                            latitude:
                              type: string
                              nullable: true
                            longitude:
                              type: string
                              nullable: true
                            continent:
                              type: string
                              nullable: true
                            asn:
                              type: object
                              properties:
                                code:
                                  type: number
                                  nullable: true
                                name:
                                  type: string
                                  nullable: true
                              required:
                                - code
                                - name
                              additionalProperties: false
                            colo:
                              type: string
                              nullable: true
                            metroCode:
                              type: string
                              nullable: true
                            isEU:
                              type: boolean
                              nullable: true
                            botManagement:
                              type: object
                              properties:
                                score:
                                  type: number
                                  nullable: true
                                verifiedBot:
                                  type: boolean
                                  nullable: true
                                corporateProxy:
                                  type: boolean
                                  nullable: true
                                verifiedBotCategory:
                                  type: string
                                  nullable: true
                              required:
                                - score
                                - verifiedBot
                                - corporateProxy
                                - verifiedBotCategory
                              additionalProperties: false
                          required:
                            - ip
                            - country
                            - city
                            - region
                            - regionCode
                            - postalCode
                            - latitude
                            - longitude
                            - continent
                            - asn
                            - colo
                            - metroCode
                            - isEU
                            - botManagement
                          additionalProperties: false
                        options:
                          type: object
                          additionalProperties: {}
                          default: {}
                      required:
                        - pid
                        - vid
                        - sid
                        - tenant
                        - createdAt
                        - endedAt
                        - utm
                        - referrer
                        - landingPage
                        - landingTitle
                        - gclid
                        - fbclid
                        - userAgent
                        - screen
                        - timezone
                        - network
                      additionalProperties: false
                      nullable: true
                  required:
                    - attribution
                    - identity
                    - session
                  additionalProperties: false
      responses:
        '200':
          description: Webhook received successfully
        4XX:
          description: Client error - webhook will be retried
        5XX:
          description: Server error - webhook will be retried
  identity.enriched:
    post:
      summary: Identity Enriched
      description: >-
        Fired once the full intelligence gathering process is complete. Delivers
        the most comprehensive payload available, including deep-tier
        firmographics, technographics, and social signals. Designed for lead
        scoring, database syncing, and marketing automation.
      operationId: webhook_identity_enriched
      tags:
        - webhooks
      parameters:
        - name: webhook-id
          in: header
          required: true
          description: Unique identifier for the webhook message
          schema:
            type: string
            example: evt_01KHEWZ09CQB36JZ5F7D3ZB9NE
        - name: webhook-timestamp
          in: header
          required: true
          description: Unix timestamp (seconds) when the webhook was sent
          schema:
            type: string
            example: '1739571908'
        - name: webhook-signature
          in: header
          required: true
          description: 'HMAC-SHA256 signature: v1,<base64-signature>'
          schema:
            type: string
            example: v1,K3jXN8AQM9LWM0D4loKWxJek...
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - id
                - type
                - created
                - data
              properties:
                id:
                  type: string
                  description: Unique event identifier
                  example: evt_01KHEWZ09CQB36JZ5F7D3ZB9NE
                type:
                  type: string
                  const: identity.enriched
                  description: Event type identifier
                created:
                  type: integer
                  description: Unix timestamp (milliseconds) when the event was created
                  example: 1739571908123
                data:
                  type: object
                  properties:
                    attribution:
                      type: object
                      properties:
                        type:
                          type: string
                          enum:
                            - website
                        pixelId:
                          type: string
                        sessionId:
                          type: string
                        vid:
                          type: string
                        prid:
                          type: string
                          enum:
                            - jNNdd
                            - OMzN4
                      required:
                        - type
                        - pixelId
                        - sessionId
                        - vid
                        - prid
                      additionalProperties: false
                    session:
                      type: object
                      properties:
                        pid:
                          type: string
                        vid:
                          type: string
                        sid:
                          type: string
                        tenant:
                          type: string
                          nullable: true
                        createdAt:
                          type: number
                        endedAt:
                          type: number
                          nullable: true
                        utm:
                          type: object
                          properties:
                            source:
                              type: string
                              nullable: true
                            medium:
                              type: string
                              nullable: true
                            campaign:
                              type: string
                              nullable: true
                            term:
                              type: string
                              nullable: true
                            content:
                              type: string
                              nullable: true
                          required:
                            - source
                            - medium
                            - campaign
                            - term
                            - content
                          additionalProperties: false
                        referrer:
                          type: string
                          nullable: true
                        landingPage:
                          type: string
                        landingTitle:
                          type: string
                          nullable: true
                        gclid:
                          type: string
                          nullable: true
                        fbclid:
                          type: string
                          nullable: true
                        userAgent:
                          type: string
                        screen:
                          type: object
                          properties:
                            width:
                              type: number
                            height:
                              type: number
                          required:
                            - width
                            - height
                          additionalProperties: false
                        timezone:
                          type: string
                        network:
                          type: object
                          properties:
                            ip:
                              type: string
                              nullable: true
                            country:
                              type: string
                              nullable: true
                            city:
                              type: string
                              nullable: true
                            region:
                              type: string
                              nullable: true
                            regionCode:
                              type: string
                              nullable: true
                            postalCode:
                              type: string
                              nullable: true
                            latitude:
                              type: string
                              nullable: true
                            longitude:
                              type: string
                              nullable: true
                            continent:
                              type: string
                              nullable: true
                            asn:
                              type: object
                              properties:
                                code:
                                  type: number
                                  nullable: true
                                name:
                                  type: string
                                  nullable: true
                              required:
                                - code
                                - name
                              additionalProperties: false
                            colo:
                              type: string
                              nullable: true
                            metroCode:
                              type: string
                              nullable: true
                            isEU:
                              type: boolean
                              nullable: true
                            botManagement:
                              type: object
                              properties:
                                score:
                                  type: number
                                  nullable: true
                                verifiedBot:
                                  type: boolean
                                  nullable: true
                                corporateProxy:
                                  type: boolean
                                  nullable: true
                                verifiedBotCategory:
                                  type: string
                                  nullable: true
                              required:
                                - score
                                - verifiedBot
                                - corporateProxy
                                - verifiedBotCategory
                              additionalProperties: false
                          required:
                            - ip
                            - country
                            - city
                            - region
                            - regionCode
                            - postalCode
                            - latitude
                            - longitude
                            - continent
                            - asn
                            - colo
                            - metroCode
                            - isEU
                            - botManagement
                          additionalProperties: false
                        options:
                          type: object
                          additionalProperties: {}
                          default: {}
                      required:
                        - pid
                        - vid
                        - sid
                        - tenant
                        - createdAt
                        - endedAt
                        - utm
                        - referrer
                        - landingPage
                        - landingTitle
                        - gclid
                        - fbclid
                        - userAgent
                        - screen
                        - timezone
                        - network
                      additionalProperties: false
                      nullable: true
                    query:
                      type: object
                      properties:
                        type:
                          type: string
                          enum:
                            - person
                        match:
                          type: string
                          enum:
                            - linkedinUrl
                        value:
                          type: string
                      required:
                        - type
                        - match
                        - value
                      additionalProperties: false
                    enrichment:
                      type: object
                      properties:
                        person:
                          type: object
                          properties:
                            firstName:
                              type: string
                              nullable: true
                            lastName:
                              type: string
                              nullable: true
                            fullName:
                              type: string
                              nullable: true
                            linkedinUrl:
                              type: string
                              format: uri
                            linkedinId:
                              type: string
                              nullable: true
                            headline:
                              type: string
                              nullable: true
                            summary:
                              type: string
                              nullable: true
                            profilePictureUrl:
                              type: string
                              format: uri
                              nullable: true
                            email:
                              type: string
                              format: email
                              nullable: true
                            location:
                              type: object
                              properties:
                                locality:
                                  type: string
                                  nullable: true
                                region:
                                  type: string
                                  nullable: true
                                postalCode:
                                  type: string
                                  nullable: true
                                country:
                                  type: string
                                  nullable: true
                                countryCode:
                                  type: string
                                  nullable: true
                                raw:
                                  type: string
                                  nullable: true
                              additionalProperties: false
                              nullable: true
                            connections:
                              type: number
                              nullable: true
                            skills:
                              type: array
                              items:
                                type: string
                              default: []
                            languages:
                              type: array
                              items:
                                type: string
                              default: []
                            employments:
                              type: array
                              items:
                                type: object
                                properties:
                                  title:
                                    type: string
                                  description:
                                    type: string
                                    nullable: true
                                  location:
                                    type: string
                                    nullable: true
                                  startDate:
                                    type: string
                                    nullable: true
                                  endDate:
                                    type: string
                                    nullable: true
                                  company:
                                    type: object
                                    properties:
                                      name:
                                        type: string
                                      linkedinId:
                                        type: string
                                        nullable: true
                                      linkedinUrl:
                                        type: string
                                        format: uri
                                        nullable: true
                                      logoUrl:
                                        type: string
                                        format: uri
                                        nullable: true
                                      domain:
                                        type: string
                                        nullable: true
                                      website:
                                        type: string
                                        format: uri
                                        nullable: true
                                      address:
                                        type: object
                                        properties:
                                          locality:
                                            type: string
                                            nullable: true
                                          region:
                                            type: string
                                            nullable: true
                                          postalCode:
                                            type: string
                                            nullable: true
                                          country:
                                            type: string
                                            nullable: true
                                          countryCode:
                                            type: string
                                            nullable: true
                                        additionalProperties: false
                                        nullable: true
                                      description:
                                        type: string
                                        nullable: true
                                      industry:
                                        type: string
                                        nullable: true
                                      employeeCount:
                                        type: number
                                        nullable: true
                                      foundedYear:
                                        type: number
                                        nullable: true
                                      _type:
                                        type: string
                                        enum:
                                          - full
                                      specialties:
                                        type: array
                                        items:
                                          type: string
                                        default: []
                                      estimatedRevenue:
                                        type: object
                                        properties:
                                          min:
                                            type: number
                                            nullable: true
                                          max:
                                            type: number
                                            nullable: true
                                          currency:
                                            type: string
                                            default: USD
                                        additionalProperties: false
                                        nullable: true
                                      headcount:
                                        type: object
                                        properties:
                                          total:
                                            type: number
                                            nullable: true
                                          growth:
                                            type: object
                                            properties:
                                              mom:
                                                type: number
                                                nullable: true
                                              qoq:
                                                type: number
                                                nullable: true
                                              yoy:
                                                type: number
                                                nullable: true
                                            additionalProperties: false
                                            nullable: true
                                        additionalProperties: false
                                        nullable: true
                                      taxonomy:
                                        type: object
                                        properties:
                                          linkedinIndustry:
                                            type: string
                                            nullable: true
                                          linkedinSpecialties:
                                            type: array
                                            items:
                                              type: string
                                            default: []
                                        additionalProperties: false
                                        nullable: true
                                      webTraffic:
                                        type: object
                                        properties:
                                          monthlyVisitors:
                                            type: number
                                            nullable: true
                                          momGrowthPercent:
                                            type: number
                                            nullable: true
                                          qoqGrowthPercent:
                                            type: number
                                            nullable: true
                                          trafficSources:
                                            type: object
                                            properties:
                                              socialPercent:
                                                type: number
                                                nullable: true
                                              searchPercent:
                                                type: number
                                                nullable: true
                                              directPercent:
                                                type: number
                                                nullable: true
                                              paidReferralPercent:
                                                type: number
                                                nullable: true
                                              referralPercent:
                                                type: number
                                                nullable: true
                                            additionalProperties: false
                                            nullable: true
                                        additionalProperties: false
                                        nullable: true
                                      linkedinFollowers:
                                        type: object
                                        properties:
                                          count:
                                            type: number
                                            nullable: true
                                          momGrowthPercent:
                                            type: number
                                            nullable: true
                                          qoqGrowthPercent:
                                            type: number
                                            nullable: true
                                          yoyGrowthPercent:
                                            type: number
                                            nullable: true
                                        additionalProperties: false
                                        nullable: true
                                      funding:
                                        type: object
                                        properties:
                                          totalRaisedUsd:
                                            type: number
                                            nullable: true
                                          lastRoundType:
                                            type: string
                                            nullable: true
                                          lastRoundAmountUsd:
                                            type: number
                                            nullable: true
                                          daysSinceLastRound:
                                            type: number
                                            nullable: true
                                          investors:
                                            type: array
                                            items:
                                              type: string
                                            default: []
                                        additionalProperties: false
                                        nullable: true
                                      seo:
                                        type: object
                                        properties:
                                          monthlyOrganicClicks:
                                            type: number
                                            nullable: true
                                          monthlyPaidClicks:
                                            type: number
                                            nullable: true
                                          monthlyOrganicValue:
                                            type: number
                                            nullable: true
                                          monthlyAdsSpend:
                                            type: number
                                            nullable: true
                                          averageOrganicRank:
                                            type: number
                                            nullable: true
                                          averageAdRank:
                                            type: number
                                            nullable: true
                                          totalOrganicKeywords:
                                            type: number
                                            nullable: true
                                        additionalProperties: false
                                        nullable: true
                                      enrichedAt:
                                        type: string
                                      provider:
                                        type: string
                                        enum:
                                          - xK9mP
                                          - qR7nL
                                    required:
                                      - name
                                      - _type
                                      - enrichedAt
                                      - provider
                                    additionalProperties: false
                                required:
                                  - title
                                  - company
                                additionalProperties: false
                              default: []
                            experience:
                              type: array
                              items:
                                type: object
                                properties:
                                  title:
                                    type: string
                                  description:
                                    type: string
                                    nullable: true
                                  location:
                                    type: string
                                    nullable: true
                                  startDate:
                                    type: string
                                    nullable: true
                                  endDate:
                                    type: string
                                    nullable: true
                                  company:
                                    type: object
                                    properties:
                                      name:
                                        type: string
                                      linkedinId:
                                        type: string
                                        nullable: true
                                      linkedinUrl:
                                        type: string
                                        format: uri
                                        nullable: true
                                      logoUrl:
                                        type: string
                                        format: uri
                                        nullable: true
                                      domain:
                                        type: string
                                        nullable: true
                                      website:
                                        type: string
                                        format: uri
                                        nullable: true
                                      address:
                                        type: object
                                        properties:
                                          locality:
                                            type: string
                                            nullable: true
                                          region:
                                            type: string
                                            nullable: true
                                          postalCode:
                                            type: string
                                            nullable: true
                                          country:
                                            type: string
                                            nullable: true
                                          countryCode:
                                            type: string
                                            nullable: true
                                        additionalProperties: false
                                        nullable: true
                                      description:
                                        type: string
                                        nullable: true
                                      industry:
                                        type: string
                                        nullable: true
                                      employeeCount:
                                        type: number
                                        nullable: true
                                      foundedYear:
                                        type: number
                                        nullable: true
                                      _type:
                                        type: string
                                        enum:
                                          - basic
                                    required:
                                      - name
                                      - _type
                                    additionalProperties: false
                                required:
                                  - title
                                  - company
                                additionalProperties: false
                              default: []
                            education:
                              type: array
                              items:
                                type: object
                                properties:
                                  instituteName:
                                    type: string
                                  instituteLinkedinId:
                                    type: string
                                    nullable: true
                                  instituteLogoUrl:
                                    type: string
                                    format: uri
                                    nullable: true
                                  degree:
                                    type: string
                                    nullable: true
                                  fieldOfStudy:
                                    type: string
                                    nullable: true
                                  startDate:
                                    type: string
                                    nullable: true
                                  endDate:
                                    type: string
                                    nullable: true
                                required:
                                  - instituteName
                                additionalProperties: false
                              default: []
                            enrichedAt:
                              type: string
                            provider:
                              type: string
                              enum:
                                - xK9mP
                                - qR7nL
                          required:
                            - linkedinUrl
                            - enrichedAt
                            - provider
                          additionalProperties: false
                          nullable: true
                        companies:
                          type: array
                          items:
                            type: object
                            properties:
                              name:
                                type: string
                              linkedinId:
                                type: string
                                nullable: true
                              linkedinUrl:
                                type: string
                                format: uri
                                nullable: true
                              logoUrl:
                                type: string
                                format: uri
                                nullable: true
                              domain:
                                type: string
                                nullable: true
                              website:
                                type: string
                                format: uri
                                nullable: true
                              address:
                                type: object
                                properties:
                                  locality:
                                    type: string
                                    nullable: true
                                  region:
                                    type: string
                                    nullable: true
                                  postalCode:
                                    type: string
                                    nullable: true
                                  country:
                                    type: string
                                    nullable: true
                                  countryCode:
                                    type: string
                                    nullable: true
                                additionalProperties: false
                                nullable: true
                              description:
                                type: string
                                nullable: true
                              industry:
                                type: string
                                nullable: true
                              employeeCount:
                                type: number
                                nullable: true
                              foundedYear:
                                type: number
                                nullable: true
                              _type:
                                type: string
                                enum:
                                  - full
                              specialties:
                                type: array
                                items:
                                  type: string
                                default: []
                              estimatedRevenue:
                                type: object
                                properties:
                                  min:
                                    type: number
                                    nullable: true
                                  max:
                                    type: number
                                    nullable: true
                                  currency:
                                    type: string
                                    default: USD
                                additionalProperties: false
                                nullable: true
                              headcount:
                                type: object
                                properties:
                                  total:
                                    type: number
                                    nullable: true
                                  growth:
                                    type: object
                                    properties:
                                      mom:
                                        type: number
                                        nullable: true
                                      qoq:
                                        type: number
                                        nullable: true
                                      yoy:
                                        type: number
                                        nullable: true
                                    additionalProperties: false
                                    nullable: true
                                additionalProperties: false
                                nullable: true
                              taxonomy:
                                type: object
                                properties:
                                  linkedinIndustry:
                                    type: string
                                    nullable: true
                                  linkedinSpecialties:
                                    type: array
                                    items:
                                      type: string
                                    default: []
                                additionalProperties: false
                                nullable: true
                              webTraffic:
                                type: object
                                properties:
                                  monthlyVisitors:
                                    type: number
                                    nullable: true
                                  momGrowthPercent:
                                    type: number
                                    nullable: true
                                  qoqGrowthPercent:
                                    type: number
                                    nullable: true
                                  trafficSources:
                                    type: object
                                    properties:
                                      socialPercent:
                                        type: number
                                        nullable: true
                                      searchPercent:
                                        type: number
                                        nullable: true
                                      directPercent:
                                        type: number
                                        nullable: true
                                      paidReferralPercent:
                                        type: number
                                        nullable: true
                                      referralPercent:
                                        type: number
                                        nullable: true
                                    additionalProperties: false
                                    nullable: true
                                additionalProperties: false
                                nullable: true
                              linkedinFollowers:
                                type: object
                                properties:
                                  count:
                                    type: number
                                    nullable: true
                                  momGrowthPercent:
                                    type: number
                                    nullable: true
                                  qoqGrowthPercent:
                                    type: number
                                    nullable: true
                                  yoyGrowthPercent:
                                    type: number
                                    nullable: true
                                additionalProperties: false
                                nullable: true
                              funding:
                                type: object
                                properties:
                                  totalRaisedUsd:
                                    type: number
                                    nullable: true
                                  lastRoundType:
                                    type: string
                                    nullable: true
                                  lastRoundAmountUsd:
                                    type: number
                                    nullable: true
                                  daysSinceLastRound:
                                    type: number
                                    nullable: true
                                  investors:
                                    type: array
                                    items:
                                      type: string
                                    default: []
                                additionalProperties: false
                                nullable: true
                              seo:
                                type: object
                                properties:
                                  monthlyOrganicClicks:
                                    type: number
                                    nullable: true
                                  monthlyPaidClicks:
                                    type: number
                                    nullable: true
                                  monthlyOrganicValue:
                                    type: number
                                    nullable: true
                                  monthlyAdsSpend:
                                    type: number
                                    nullable: true
                                  averageOrganicRank:
                                    type: number
                                    nullable: true
                                  averageAdRank:
                                    type: number
                                    nullable: true
                                  totalOrganicKeywords:
                                    type: number
                                    nullable: true
                                additionalProperties: false
                                nullable: true
                              enrichedAt:
                                type: string
                              provider:
                                type: string
                                enum:
                                  - xK9mP
                                  - qR7nL
                            required:
                              - name
                              - _type
                              - enrichedAt
                              - provider
                            additionalProperties: false
                        emailValidations:
                          type: array
                          items:
                            type: object
                            properties:
                              email:
                                type: string
                              validity:
                                type: string
                                enum:
                                  - valid
                                  - invalid
                                  - catch_all
                                  - valid_catch_all
                                nullable: true
                              provider:
                                type: string
                              error:
                                type: object
                                properties:
                                  code:
                                    type: string
                                  message:
                                    type: string
                                required:
                                  - code
                                  - message
                                additionalProperties: false
                                nullable: true
                            required:
                              - email
                              - validity
                              - provider
                              - error
                            additionalProperties: false
                          default: []
                      required:
                        - person
                        - companies
                      additionalProperties: false
                      nullable: true
                    companiesEnriched:
                      type: number
                  required:
                    - attribution
                    - session
                    - query
                    - enrichment
                    - companiesEnriched
                  additionalProperties: false
      responses:
        '200':
          description: Webhook received successfully
        4XX:
          description: Client error - webhook will be retried
        5XX:
          description: Server error - webhook will be retried
  identity.validated:
    post:
      summary: Identity Validated
      description: >-
        Fired when email validation completes. One event is sent per email
        validated. Contains validity status (valid, invalid, catch_all,
        valid_catch_all) and provider information.
      operationId: webhook_identity_validated
      tags:
        - webhooks
      parameters:
        - name: webhook-id
          in: header
          required: true
          description: Unique identifier for the webhook message
          schema:
            type: string
            example: evt_01KHEWZ09CQB36JZ5F7D3ZB9NE
        - name: webhook-timestamp
          in: header
          required: true
          description: Unix timestamp (seconds) when the webhook was sent
          schema:
            type: string
            example: '1739571908'
        - name: webhook-signature
          in: header
          required: true
          description: 'HMAC-SHA256 signature: v1,<base64-signature>'
          schema:
            type: string
            example: v1,K3jXN8AQM9LWM0D4loKWxJek...
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - id
                - type
                - created
                - data
              properties:
                id:
                  type: string
                  description: Unique event identifier
                  example: evt_01KHEWZ09CQB36JZ5F7D3ZB9NE
                type:
                  type: string
                  const: identity.validated
                  description: Event type identifier
                created:
                  type: integer
                  description: Unix timestamp (milliseconds) when the event was created
                  example: 1739571908123
                data:
                  type: object
                  properties:
                    attribution:
                      type: object
                      properties:
                        type:
                          type: string
                          enum:
                            - website
                        pixelId:
                          type: string
                        sessionId:
                          type: string
                        vid:
                          type: string
                        prid:
                          type: string
                          enum:
                            - jNNdd
                            - OMzN4
                      required:
                        - type
                        - pixelId
                        - sessionId
                        - vid
                        - prid
                      additionalProperties: false
                    validations:
                      type: array
                      items:
                        type: object
                        properties:
                          email:
                            type: string
                          validity:
                            type: string
                            enum:
                              - valid
                              - invalid
                              - catch_all
                              - valid_catch_all
                            nullable: true
                          provider:
                            type: string
                          error:
                            type: object
                            properties:
                              code:
                                type: string
                              message:
                                type: string
                            required:
                              - code
                              - message
                            additionalProperties: false
                            nullable: true
                        required:
                          - email
                          - validity
                          - provider
                          - error
                        additionalProperties: false
                    session:
                      type: object
                      properties:
                        pid:
                          type: string
                        vid:
                          type: string
                        sid:
                          type: string
                        tenant:
                          type: string
                          nullable: true
                        createdAt:
                          type: number
                        endedAt:
                          type: number
                          nullable: true
                        utm:
                          type: object
                          properties:
                            source:
                              type: string
                              nullable: true
                            medium:
                              type: string
                              nullable: true
                            campaign:
                              type: string
                              nullable: true
                            term:
                              type: string
                              nullable: true
                            content:
                              type: string
                              nullable: true
                          required:
                            - source
                            - medium
                            - campaign
                            - term
                            - content
                          additionalProperties: false
                        referrer:
                          type: string
                          nullable: true
                        landingPage:
                          type: string
                        landingTitle:
                          type: string
                          nullable: true
                        gclid:
                          type: string
                          nullable: true
                        fbclid:
                          type: string
                          nullable: true
                        userAgent:
                          type: string
                        screen:
                          type: object
                          properties:
                            width:
                              type: number
                            height:
                              type: number
                          required:
                            - width
                            - height
                          additionalProperties: false
                        timezone:
                          type: string
                        network:
                          type: object
                          properties:
                            ip:
                              type: string
                              nullable: true
                            country:
                              type: string
                              nullable: true
                            city:
                              type: string
                              nullable: true
                            region:
                              type: string
                              nullable: true
                            regionCode:
                              type: string
                              nullable: true
                            postalCode:
                              type: string
                              nullable: true
                            latitude:
                              type: string
                              nullable: true
                            longitude:
                              type: string
                              nullable: true
                            continent:
                              type: string
                              nullable: true
                            asn:
                              type: object
                              properties:
                                code:
                                  type: number
                                  nullable: true
                                name:
                                  type: string
                                  nullable: true
                              required:
                                - code
                                - name
                              additionalProperties: false
                            colo:
                              type: string
                              nullable: true
                            metroCode:
                              type: string
                              nullable: true
                            isEU:
                              type: boolean
                              nullable: true
                            botManagement:
                              type: object
                              properties:
                                score:
                                  type: number
                                  nullable: true
                                verifiedBot:
                                  type: boolean
                                  nullable: true
                                corporateProxy:
                                  type: boolean
                                  nullable: true
                                verifiedBotCategory:
                                  type: string
                                  nullable: true
                              required:
                                - score
                                - verifiedBot
                                - corporateProxy
                                - verifiedBotCategory
                              additionalProperties: false
                          required:
                            - ip
                            - country
                            - city
                            - region
                            - regionCode
                            - postalCode
                            - latitude
                            - longitude
                            - continent
                            - asn
                            - colo
                            - metroCode
                            - isEU
                            - botManagement
                          additionalProperties: false
                        options:
                          type: object
                          additionalProperties: {}
                          default: {}
                      required:
                        - pid
                        - vid
                        - sid
                        - tenant
                        - createdAt
                        - endedAt
                        - utm
                        - referrer
                        - landingPage
                        - landingTitle
                        - gclid
                        - fbclid
                        - userAgent
                        - screen
                        - timezone
                        - network
                      additionalProperties: false
                      nullable: true
                  required:
                    - attribution
                    - validations
                    - session
                  additionalProperties: false
      responses:
        '200':
          description: Webhook received successfully
        4XX:
          description: Client error - webhook will be retried
        5XX:
          description: Server error - webhook will be retried
  identity.session.finalized:
    post:
      summary: Identity Session Finalized
      description: >-
        Fired after a session has concluded due to inactivity or manual
        termination. Includes all data from identity.enriched plus an aggregate
        summary of the user journey, including total engagement time and all
        pages visited. Serves as the final record for attribution modeling and
        historical reporting.
      operationId: webhook_identity_session_finalized
      tags:
        - webhooks
      parameters:
        - name: webhook-id
          in: header
          required: true
          description: Unique identifier for the webhook message
          schema:
            type: string
            example: evt_01KHEWZ09CQB36JZ5F7D3ZB9NE
        - name: webhook-timestamp
          in: header
          required: true
          description: Unix timestamp (seconds) when the webhook was sent
          schema:
            type: string
            example: '1739571908'
        - name: webhook-signature
          in: header
          required: true
          description: 'HMAC-SHA256 signature: v1,<base64-signature>'
          schema:
            type: string
            example: v1,K3jXN8AQM9LWM0D4loKWxJek...
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - id
                - type
                - created
                - data
              properties:
                id:
                  type: string
                  description: Unique event identifier
                  example: evt_01KHEWZ09CQB36JZ5F7D3ZB9NE
                type:
                  type: string
                  const: identity.session.finalized
                  description: Event type identifier
                created:
                  type: integer
                  description: Unix timestamp (milliseconds) when the event was created
                  example: 1739571908123
                data:
                  type: object
                  properties:
                    session:
                      type: object
                      properties:
                        pid:
                          type: string
                        vid:
                          type: string
                        sid:
                          type: string
                        tenant:
                          type: string
                          nullable: true
                        createdAt:
                          type: number
                        lastActivity:
                          type: number
                        endedAt:
                          type: number
                          nullable: true
                        utm:
                          type: object
                          properties:
                            source:
                              type: string
                              nullable: true
                            medium:
                              type: string
                              nullable: true
                            campaign:
                              type: string
                              nullable: true
                            term:
                              type: string
                              nullable: true
                            content:
                              type: string
                              nullable: true
                          required:
                            - source
                            - medium
                            - campaign
                            - term
                            - content
                          additionalProperties: false
                        referrer:
                          type: string
                          nullable: true
                        landingPage:
                          type: string
                        landingTitle:
                          type: string
                          nullable: true
                        gclid:
                          type: string
                          nullable: true
                        fbclid:
                          type: string
                          nullable: true
                        userAgent:
                          type: string
                        screen:
                          type: object
                          properties:
                            width:
                              type: number
                            height:
                              type: number
                          required:
                            - width
                            - height
                          additionalProperties: false
                        timezone:
                          type: string
                        network:
                          type: object
                          properties:
                            ip:
                              type: string
                              nullable: true
                            country:
                              type: string
                              nullable: true
                            city:
                              type: string
                              nullable: true
                            region:
                              type: string
                              nullable: true
                            regionCode:
                              type: string
                              nullable: true
                            postalCode:
                              type: string
                              nullable: true
                            latitude:
                              type: string
                              nullable: true
                            longitude:
                              type: string
                              nullable: true
                            continent:
                              type: string
                              nullable: true
                            asn:
                              type: object
                              properties:
                                code:
                                  type: number
                                  nullable: true
                                name:
                                  type: string
                                  nullable: true
                              required:
                                - code
                                - name
                              additionalProperties: false
                            colo:
                              type: string
                              nullable: true
                            metroCode:
                              type: string
                              nullable: true
                            isEU:
                              type: boolean
                              nullable: true
                            botManagement:
                              type: object
                              properties:
                                score:
                                  type: number
                                  nullable: true
                                verifiedBot:
                                  type: boolean
                                  nullable: true
                                corporateProxy:
                                  type: boolean
                                  nullable: true
                                verifiedBotCategory:
                                  type: string
                                  nullable: true
                              required:
                                - score
                                - verifiedBot
                                - corporateProxy
                                - verifiedBotCategory
                              additionalProperties: false
                          required:
                            - ip
                            - country
                            - city
                            - region
                            - regionCode
                            - postalCode
                            - latitude
                            - longitude
                            - continent
                            - asn
                            - colo
                            - metroCode
                            - isEU
                            - botManagement
                          additionalProperties: false
                        options:
                          type: object
                          additionalProperties: {}
                          default: {}
                        events:
                          type: array
                          items:
                            type: object
                            properties:
                              signal:
                                type: string
                              url:
                                type: string
                              ts:
                                type: number
                              v:
                                type: string
                              title:
                                type: string
                                nullable: true
                              ref:
                                type: string
                                nullable: true
                              outlink:
                                type: string
                                nullable: true
                              props:
                                type: object
                                additionalProperties: {}
                                nullable: true
                            required:
                              - signal
                              - url
                              - ts
                              - v
                              - title
                              - ref
                              - outlink
                              - props
                            additionalProperties: false
                        enrichments:
                          type: array
                          items:
                            type: object
                            properties:
                              enrichedAt:
                                type: number
                              enrichmentData:
                                type: string
                            required:
                              - enrichedAt
                              - enrichmentData
                            additionalProperties: false
                      required:
                        - pid
                        - vid
                        - sid
                        - tenant
                        - createdAt
                        - lastActivity
                        - endedAt
                        - utm
                        - referrer
                        - landingPage
                        - landingTitle
                        - gclid
                        - fbclid
                        - userAgent
                        - screen
                        - timezone
                        - network
                        - events
                      additionalProperties: false
                    enrichment:
                      type: object
                      properties:
                        person:
                          type: object
                          properties:
                            firstName:
                              type: string
                              nullable: true
                            lastName:
                              type: string
                              nullable: true
                            fullName:
                              type: string
                              nullable: true
                            linkedinUrl:
                              type: string
                              format: uri
                            linkedinId:
                              type: string
                              nullable: true
                            headline:
                              type: string
                              nullable: true
                            summary:
                              type: string
                              nullable: true
                            profilePictureUrl:
                              type: string
                              format: uri
                              nullable: true
                            email:
                              type: string
                              format: email
                              nullable: true
                            location:
                              type: object
                              properties:
                                locality:
                                  type: string
                                  nullable: true
                                region:
                                  type: string
                                  nullable: true
                                postalCode:
                                  type: string
                                  nullable: true
                                country:
                                  type: string
                                  nullable: true
                                countryCode:
                                  type: string
                                  nullable: true
                                raw:
                                  type: string
                                  nullable: true
                              additionalProperties: false
                              nullable: true
                            connections:
                              type: number
                              nullable: true
                            skills:
                              type: array
                              items:
                                type: string
                              default: []
                            languages:
                              type: array
                              items:
                                type: string
                              default: []
                            employments:
                              type: array
                              items:
                                type: object
                                properties:
                                  title:
                                    type: string
                                  description:
                                    type: string
                                    nullable: true
                                  location:
                                    type: string
                                    nullable: true
                                  startDate:
                                    type: string
                                    nullable: true
                                  endDate:
                                    type: string
                                    nullable: true
                                  company:
                                    type: object
                                    properties:
                                      name:
                                        type: string
                                      linkedinId:
                                        type: string
                                        nullable: true
                                      linkedinUrl:
                                        type: string
                                        format: uri
                                        nullable: true
                                      logoUrl:
                                        type: string
                                        format: uri
                                        nullable: true
                                      domain:
                                        type: string
                                        nullable: true
                                      website:
                                        type: string
                                        format: uri
                                        nullable: true
                                      address:
                                        type: object
                                        properties:
                                          locality:
                                            type: string
                                            nullable: true
                                          region:
                                            type: string
                                            nullable: true
                                          postalCode:
                                            type: string
                                            nullable: true
                                          country:
                                            type: string
                                            nullable: true
                                          countryCode:
                                            type: string
                                            nullable: true
                                        additionalProperties: false
                                        nullable: true
                                      description:
                                        type: string
                                        nullable: true
                                      industry:
                                        type: string
                                        nullable: true
                                      employeeCount:
                                        type: number
                                        nullable: true
                                      foundedYear:
                                        type: number
                                        nullable: true
                                      _type:
                                        type: string
                                        enum:
                                          - full
                                      specialties:
                                        type: array
                                        items:
                                          type: string
                                        default: []
                                      estimatedRevenue:
                                        type: object
                                        properties:
                                          min:
                                            type: number
                                            nullable: true
                                          max:
                                            type: number
                                            nullable: true
                                          currency:
                                            type: string
                                            default: USD
                                        additionalProperties: false
                                        nullable: true
                                      headcount:
                                        type: object
                                        properties:
                                          total:
                                            type: number
                                            nullable: true
                                          growth:
                                            type: object
                                            properties:
                                              mom:
                                                type: number
                                                nullable: true
                                              qoq:
                                                type: number
                                                nullable: true
                                              yoy:
                                                type: number
                                                nullable: true
                                            additionalProperties: false
                                            nullable: true
                                        additionalProperties: false
                                        nullable: true
                                      taxonomy:
                                        type: object
                                        properties:
                                          linkedinIndustry:
                                            type: string
                                            nullable: true
                                          linkedinSpecialties:
                                            type: array
                                            items:
                                              type: string
                                            default: []
                                        additionalProperties: false
                                        nullable: true
                                      webTraffic:
                                        type: object
                                        properties:
                                          monthlyVisitors:
                                            type: number
                                            nullable: true
                                          momGrowthPercent:
                                            type: number
                                            nullable: true
                                          qoqGrowthPercent:
                                            type: number
                                            nullable: true
                                          trafficSources:
                                            type: object
                                            properties:
                                              socialPercent:
                                                type: number
                                                nullable: true
                                              searchPercent:
                                                type: number
                                                nullable: true
                                              directPercent:
                                                type: number
                                                nullable: true
                                              paidReferralPercent:
                                                type: number
                                                nullable: true
                                              referralPercent:
                                                type: number
                                                nullable: true
                                            additionalProperties: false
                                            nullable: true
                                        additionalProperties: false
                                        nullable: true
                                      linkedinFollowers:
                                        type: object
                                        properties:
                                          count:
                                            type: number
                                            nullable: true
                                          momGrowthPercent:
                                            type: number
                                            nullable: true
                                          qoqGrowthPercent:
                                            type: number
                                            nullable: true
                                          yoyGrowthPercent:
                                            type: number
                                            nullable: true
                                        additionalProperties: false
                                        nullable: true
                                      funding:
                                        type: object
                                        properties:
                                          totalRaisedUsd:
                                            type: number
                                            nullable: true
                                          lastRoundType:
                                            type: string
                                            nullable: true
                                          lastRoundAmountUsd:
                                            type: number
                                            nullable: true
                                          daysSinceLastRound:
                                            type: number
                                            nullable: true
                                          investors:
                                            type: array
                                            items:
                                              type: string
                                            default: []
                                        additionalProperties: false
                                        nullable: true
                                      seo:
                                        type: object
                                        properties:
                                          monthlyOrganicClicks:
                                            type: number
                                            nullable: true
                                          monthlyPaidClicks:
                                            type: number
                                            nullable: true
                                          monthlyOrganicValue:
                                            type: number
                                            nullable: true
                                          monthlyAdsSpend:
                                            type: number
                                            nullable: true
                                          averageOrganicRank:
                                            type: number
                                            nullable: true
                                          averageAdRank:
                                            type: number
                                            nullable: true
                                          totalOrganicKeywords:
                                            type: number
                                            nullable: true
                                        additionalProperties: false
                                        nullable: true
                                      enrichedAt:
                                        type: string
                                      provider:
                                        type: string
                                        enum:
                                          - xK9mP
                                          - qR7nL
                                    required:
                                      - name
                                      - _type
                                      - enrichedAt
                                      - provider
                                    additionalProperties: false
                                required:
                                  - title
                                  - company
                                additionalProperties: false
                              default: []
                            experience:
                              type: array
                              items:
                                type: object
                                properties:
                                  title:
                                    type: string
                                  description:
                                    type: string
                                    nullable: true
                                  location:
                                    type: string
                                    nullable: true
                                  startDate:
                                    type: string
                                    nullable: true
                                  endDate:
                                    type: string
                                    nullable: true
                                  company:
                                    type: object
                                    properties:
                                      name:
                                        type: string
                                      linkedinId:
                                        type: string
                                        nullable: true
                                      linkedinUrl:
                                        type: string
                                        format: uri
                                        nullable: true
                                      logoUrl:
                                        type: string
                                        format: uri
                                        nullable: true
                                      domain:
                                        type: string
                                        nullable: true
                                      website:
                                        type: string
                                        format: uri
                                        nullable: true
                                      address:
                                        type: object
                                        properties:
                                          locality:
                                            type: string
                                            nullable: true
                                          region:
                                            type: string
                                            nullable: true
                                          postalCode:
                                            type: string
                                            nullable: true
                                          country:
                                            type: string
                                            nullable: true
                                          countryCode:
                                            type: string
                                            nullable: true
                                        additionalProperties: false
                                        nullable: true
                                      description:
                                        type: string
                                        nullable: true
                                      industry:
                                        type: string
                                        nullable: true
                                      employeeCount:
                                        type: number
                                        nullable: true
                                      foundedYear:
                                        type: number
                                        nullable: true
                                      _type:
                                        type: string
                                        enum:
                                          - basic
                                    required:
                                      - name
                                      - _type
                                    additionalProperties: false
                                required:
                                  - title
                                  - company
                                additionalProperties: false
                              default: []
                            education:
                              type: array
                              items:
                                type: object
                                properties:
                                  instituteName:
                                    type: string
                                  instituteLinkedinId:
                                    type: string
                                    nullable: true
                                  instituteLogoUrl:
                                    type: string
                                    format: uri
                                    nullable: true
                                  degree:
                                    type: string
                                    nullable: true
                                  fieldOfStudy:
                                    type: string
                                    nullable: true
                                  startDate:
                                    type: string
                                    nullable: true
                                  endDate:
                                    type: string
                                    nullable: true
                                required:
                                  - instituteName
                                additionalProperties: false
                              default: []
                            enrichedAt:
                              type: string
                            provider:
                              type: string
                              enum:
                                - xK9mP
                                - qR7nL
                          required:
                            - linkedinUrl
                            - enrichedAt
                            - provider
                          additionalProperties: false
                        companies:
                          type: array
                          items:
                            type: object
                            properties:
                              name:
                                type: string
                              linkedinId:
                                type: string
                                nullable: true
                              linkedinUrl:
                                type: string
                                format: uri
                                nullable: true
                              logoUrl:
                                type: string
                                format: uri
                                nullable: true
                              domain:
                                type: string
                                nullable: true
                              website:
                                type: string
                                format: uri
                                nullable: true
                              address:
                                type: object
                                properties:
                                  locality:
                                    type: string
                                    nullable: true
                                  region:
                                    type: string
                                    nullable: true
                                  postalCode:
                                    type: string
                                    nullable: true
                                  country:
                                    type: string
                                    nullable: true
                                  countryCode:
                                    type: string
                                    nullable: true
                                additionalProperties: false
                                nullable: true
                              description:
                                type: string
                                nullable: true
                              industry:
                                type: string
                                nullable: true
                              employeeCount:
                                type: number
                                nullable: true
                              foundedYear:
                                type: number
                                nullable: true
                              _type:
                                type: string
                                enum:
                                  - full
                              specialties:
                                type: array
                                items:
                                  type: string
                                default: []
                              estimatedRevenue:
                                type: object
                                properties:
                                  min:
                                    type: number
                                    nullable: true
                                  max:
                                    type: number
                                    nullable: true
                                  currency:
                                    type: string
                                    default: USD
                                additionalProperties: false
                                nullable: true
                              headcount:
                                type: object
                                properties:
                                  total:
                                    type: number
                                    nullable: true
                                  growth:
                                    type: object
                                    properties:
                                      mom:
                                        type: number
                                        nullable: true
                                      qoq:
                                        type: number
                                        nullable: true
                                      yoy:
                                        type: number
                                        nullable: true
                                    additionalProperties: false
                                    nullable: true
                                additionalProperties: false
                                nullable: true
                              taxonomy:
                                type: object
                                properties:
                                  linkedinIndustry:
                                    type: string
                                    nullable: true
                                  linkedinSpecialties:
                                    type: array
                                    items:
                                      type: string
                                    default: []
                                additionalProperties: false
                                nullable: true
                              webTraffic:
                                type: object
                                properties:
                                  monthlyVisitors:
                                    type: number
                                    nullable: true
                                  momGrowthPercent:
                                    type: number
                                    nullable: true
                                  qoqGrowthPercent:
                                    type: number
                                    nullable: true
                                  trafficSources:
                                    type: object
                                    properties:
                                      socialPercent:
                                        type: number
                                        nullable: true
                                      searchPercent:
                                        type: number
                                        nullable: true
                                      directPercent:
                                        type: number
                                        nullable: true
                                      paidReferralPercent:
                                        type: number
                                        nullable: true
                                      referralPercent:
                                        type: number
                                        nullable: true
                                    additionalProperties: false
                                    nullable: true
                                additionalProperties: false
                                nullable: true
                              linkedinFollowers:
                                type: object
                                properties:
                                  count:
                                    type: number
                                    nullable: true
                                  momGrowthPercent:
                                    type: number
                                    nullable: true
                                  qoqGrowthPercent:
                                    type: number
                                    nullable: true
                                  yoyGrowthPercent:
                                    type: number
                                    nullable: true
                                additionalProperties: false
                                nullable: true
                              funding:
                                type: object
                                properties:
                                  totalRaisedUsd:
                                    type: number
                                    nullable: true
                                  lastRoundType:
                                    type: string
                                    nullable: true
                                  lastRoundAmountUsd:
                                    type: number
                                    nullable: true
                                  daysSinceLastRound:
                                    type: number
                                    nullable: true
                                  investors:
                                    type: array
                                    items:
                                      type: string
                                    default: []
                                additionalProperties: false
                                nullable: true
                              seo:
                                type: object
                                properties:
                                  monthlyOrganicClicks:
                                    type: number
                                    nullable: true
                                  monthlyPaidClicks:
                                    type: number
                                    nullable: true
                                  monthlyOrganicValue:
                                    type: number
                                    nullable: true
                                  monthlyAdsSpend:
                                    type: number
                                    nullable: true
                                  averageOrganicRank:
                                    type: number
                                    nullable: true
                                  averageAdRank:
                                    type: number
                                    nullable: true
                                  totalOrganicKeywords:
                                    type: number
                                    nullable: true
                                additionalProperties: false
                                nullable: true
                              enrichedAt:
                                type: string
                              provider:
                                type: string
                                enum:
                                  - xK9mP
                                  - qR7nL
                            required:
                              - name
                              - _type
                              - enrichedAt
                              - provider
                            additionalProperties: false
                        emailValidations:
                          type: array
                          items:
                            type: object
                            properties:
                              email:
                                type: string
                              validity:
                                type: string
                                enum:
                                  - valid
                                  - invalid
                                  - catch_all
                                  - valid_catch_all
                                nullable: true
                              provider:
                                type: string
                              error:
                                type: object
                                properties:
                                  code:
                                    type: string
                                  message:
                                    type: string
                                required:
                                  - code
                                  - message
                                additionalProperties: false
                                nullable: true
                            required:
                              - email
                              - validity
                              - provider
                              - error
                            additionalProperties: false
                          default: []
                      required:
                        - person
                        - companies
                      additionalProperties: false
                      nullable: true
                    sessionEndedAt:
                      type: number
                    eventCount:
                      type: number
                    finalizedAt:
                      type: number
                  required:
                    - session
                    - enrichment
                    - sessionEndedAt
                    - eventCount
                    - finalizedAt
                  additionalProperties: false
      responses:
        '200':
          description: Webhook received successfully
        4XX:
          description: Client error - webhook will be retried
        5XX:
          description: Server error - webhook will be retried
