Juniper Mist Webhooks

generated: '2026-09-18'
method: derived
source: >-
  openapi/juniper-mist-api-openapi.yml (Mist API 2607.1.1, the provider's own OpenAPI 3.1
  export) + https://www.juniper.net/documentation/us/en/software/mist/automation-integration/topics/concept/webhooks.html
provider: Juniper Networks
providerId: juniper
api: Mist API
summary: >-
  Juniper Mist ships a real, well-specified webhook surface: 30 named topics, each with
  its own delivery-envelope and event schema in the published OpenAPI, five delivery
  transports, HMAC request signing, and a delivery-results search API you can query
  after the fact. There is NO AsyncAPI document — Juniper does not publish one — so this
  artifact is the webhook catalog, derived from the provider's own contract, and the
  apis.yml pointer is `Webhooks`, not `AsyncAPI`.
asyncapi:
  published: false
  note: >-
    Searched the Juniper and mistsys GitHub organizations, the Mist API Reference portal
    export formats (only postman20/openapi31json/openapi31yaml are offered) and the
    documentation site. No AsyncAPI document exists. A previous round of this repo carried
    an apis.yml pointer to asyncapi/juniper-networks-junos-telemetry-asyncapi.yml, a file
    that was never written and a document Juniper has never published; that pointer was
    removed on 2026-09-18. The real Junos telemetry contract is Protocol Buffers, captured
    in grpc/ — not AsyncAPI.
management:
  scopes:
    - level: org
      collection: /api/v1/orgs/{org_id}/webhooks
    - level: site
      collection: /api/v1/sites/{site_id}/webhooks
  operations:
    - POST /api/v1/orgs/{org_id}/webhooks
    - GET /api/v1/orgs/{org_id}/webhooks
    - GET|PUT|DELETE /api/v1/orgs/{org_id}/webhooks/{webhook_id}
    - POST /api/v1/orgs/{org_id}/webhooks/{webhook_id}/ping
    - GET /api/v1/orgs/{org_id}/webhooks/{webhook_id}/events/search
    - GET /api/v1/orgs/{org_id}/webhooks/{webhook_id}/events/count
    - POST /api/v1/sites/{site_id}/webhooks
    - GET /api/v1/sites/{site_id}/webhooks
    - GET|PUT|DELETE /api/v1/sites/{site_id}/webhooks/{webhook_id}
    - POST /api/v1/sites/{site_id}/webhooks/{webhook_id}/ping
    - GET /api/v1/sites/{site_id}/webhooks/{webhook_id}/events/search
    - GET /api/v1/sites/{site_id}/webhooks/{webhook_id}/events/count
    - GET /api/v1/const/webhook_topics
  discovery: >-
    GET /api/v1/const/webhook_topics returns the live topic list with per-topic flags
    (for_org, internal, has_delivery_results, allows_single_event_per_message) — a
    machine-readable event catalog served by the API itself.
delivery:
  transports:
    - http-post
    - oauth2
    - aws-sns
    - google-pubsub
    - splunk
  batching: >-
    Multiple events arrive in one message by default. single_event_per_message=true
    forces one event per message, and is only available on topics whose
    allows_single_event_per_message flag is set.
  custom_headers: >-
    http-post webhooks accept arbitrary request headers (name+value strings,
    under 1000 bytes total).
  tls_verification: verify_cert defaults to true for https destinations.
security:
  signing:
    mechanism: HMAC over the raw request body, using a shared secret set on the webhook
    headers:
      - name: X-Mist-Signature-v2
        algorithm: HMAC_SHA256
      - name: X-Mist-Signature
        algorithm: HMAC_SHA1
        note: legacy; prefer v2
    applies_to: type=http-post webhooks that set `secret`
    source: components.schemas.webhook.properties.secret in the published OpenAPI
  oauth2_delivery: >-
    type=oauth2 webhooks fetch a bearer token from oauth2_token_url before delivering,
    supporting client_credentials and password grants with optional oauth2_scopes.
observability:
  delivery_results: >-
    Topics with has_delivery_results expose /events/search and /events/count, returning
    webhook_delivery records. The published webhook_delivery_topic enum limits this to
    alarms, audits, device-updowns, occupancy-alerts and ping.
  ping: A POST /ping on any webhook triggers a test delivery.
topic_count: 30
topics:
  - topic: alarms
    envelope_schema: webhook_alarms
    description: "Sample of the `alarms` webhook payload.  **N.B.**: Fields like `aps`, `bssids`, `ssids` are event specific. They are relevant to this event type ( rogue-ap-detected). For a different event type, different fields may be s"
  - topic: asset-raw-rssi
    envelope_schema: webhook_asset_raw_rssi
    event_schema: webhook_asset_raw_rssi_event
    description: "Sample of the `asset-raw-rssi` webhook payload.   This webhook topic provides raw data from packets emitted by named and filtered assets.   Raw data webhooks are a special subset of webhooks that provide insight into raw"
  - topic: audits
    envelope_schema: webhook_audits
    description: "Sample of the `audits` webhook payload."
  - topic: client-info
    envelope_schema: webhook_client_info
    event_schema: webhook_client_info_event
    description: "Sample of the `client-info` webhook payload."
  - topic: client-join
    envelope_schema: webhook_client_join
    event_schema: webhook_client_join_event
    description: "Sample of the `client-join` webhook payload."
  - topic: client-latency
    envelope_schema: webhook_client_latency
    event_schema: webhook_client_latency_event
    description: "Sample of the `client-latency` webhook payload."
  - topic: client-sessions
    envelope_schema: webhook_client_sessions
    event_schema: webhook_client_sessions_event
    description: "Sample of the `client-sessions` webhook payload."
  - topic: device-events
    envelope_schema: webhook_device_events
    description: "Sample of the `device-events` webhook payload."
  - topic: device-updowns
    envelope_schema: webhook_device_updowns
    event_schema: webhook_device_updowns_event
    description: "Sample of the `device-updowns` webhook payload."
  - topic: discovered-raw-rssi
    envelope_schema: webhook_discovered_raw_rssi
    event_schema: webhook_discovered_raw_rssi_event
    description: "Sample of the `discovered-raw-rssi` webhook payload."
  - topic: guest-authorizations
    envelope_schema: webhook_guest_authorizations
    event_schema: webhook_guest_authorizations_event
    description: "Sample of the `guest-authorizations` webhook payload."
  - topic: location
    envelope_schema: webhook_location
    event_schema: webhook_location_event
    description: "Sample of the `location` webhook payload."
  - topic: location-asset
    envelope_schema: webhook_location_asset
    event_schema: webhook_location_asset_event
    description: "Sample of the `location_asset` webhook payload."
  - topic: location-centrak
    envelope_schema: webhook_location_centrak
    event_schema: webhook_location_centrak_event
    description: "Sample of the `location-centrak` webhook payload."
  - topic: location-client
    envelope_schema: webhook_location_client
    event_schema: webhook_location_client_event
    description: "Sample of the `location-client` webhook payload."
  - topic: location-sdk
    envelope_schema: webhook_location_sdk
    event_schema: webhook_location_sdk_event
    description: "Sample of the `location-sdk` webhook payload."
  - topic: location-unclient
    envelope_schema: webhook_location_unclient
    event_schema: webhook_location_unclient_event
    description: "Sample of the `location-unclient` webhook payload."
  - topic: minis-application
    envelope_schema: webhook_minis_application
    event_schema: webhook_minis_application_event
    description: "Sample of the `minis-application` webhook payload."
  - topic: minis-reachability
    envelope_schema: webhook_minis_reachability
    event_schema: webhook_minis_reachability_event
    description: "Sample of the `minis-reachability` webhook payload."
  - topic: mxedge-events
    envelope_schema: webhook_mxedge_event
    description: "Webhook topic name for Mist Edge event deliveries. enum: `mxedge-events`"
  - topic: nac-accounting
    envelope_schema: webhook_nac_accounting
    event_schema: webhook_nac_accounting_event
    description: "Sample of the `nac-accounting` webhook payload."
  - topic: nac-events
    envelope_schema: webhook_nac_events
    description: "Sample of the `nac-events` webhook payload."
  - topic: occupancy-alerts
    envelope_schema: webhook_occupancy_alerts
    event_schema: webhook_occupancy_alerts_event
    description: "Sample of the `occupancy-alerts` webhook payload."
  - topic: ping
    envelope_schema: webhook_ping
    event_schema: webhook_ping_event
    description: "Sample of the `ping` webhook payload.\n\nThe `ping` webhook can be manually sent with the following API calls:\n- for a Site level webhook with the [Ping Site Webhook]($e/Orgs%20Webhooks/pingOrgWebhook) endpoint\n- for a"
  - topic: rssizone
    envelope_schema: webhook_rssizone
    event_schema: webhook_rssizone_event
    description: "Sample of the `rssizone` webhook payload."
  - topic: sdkclient-scan-data
    envelope_schema: webhook_sdkclient_scan_data
    event_schema: webhook_sdkclient_scan_data_event
    description: "Sample of the `sdkclient-scan-data` webhook payload."
  - topic: site-sle
    envelope_schema: webhook_site_sle
    event_schema: webhook_site_sle_event
    description: "Sample of the `site-sle` webhook payload."
  - topic: wifi-conn-raw
    envelope_schema: webhook_wifi_conn_raw
    event_schema: webhook_wifi_conn_raw_event
    description: "Sample of the `wifi-conn-raw` webhook payload.   This webhook topic provides raw data from packets emitted by connected devices.   Raw data webhooks are a special subset of webhooks that provide insight into raw data pac"
  - topic: wifi-unconn-raw
    envelope_schema: webhook_wifi_unconn_raw
    event_schema: webhook_wifi_unconn_raw_event
    description: "Sample of the `wifi-unconn-raw` webhook payload.   This webhook topic provides raw data from packets emitted by unconnected devices.   Raw data webhooks are a special subset of webhooks that provide insight into raw data"
  - topic: zone
    envelope_schema: webhook_zone
    event_schema: webhook_zone_event
    description: "Sample of the `zone` webhook payload."
maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com