← All Connectors
Cisco Meraki

Cisco Meraki

meraki

Enterprise cloud-managed WiFi with CMX location services. Supports both webhook-based real-time data and REST API polling for historical data.

Configuration schema

FieldTypeRequiredDescription
api_keystringYesMeraki Dashboard API key. Generate from Dashboard > Organization > Settings > API access.
org_idstringYesMeraki organization ID. Found in Dashboard URL or via GET /organizations.
webhook_secretstringNoShared secret for validating CMX webhook payloads. Set in Dashboard > Network > Alerts.

Setup instructions

1

Enable API access in Meraki Dashboard: Organization > Settings > Dashboard API access.

2

Generate an API key: My Profile > API access > Generate API key.

3

Note your Organization ID from the Dashboard URL or GET /api/v1/organizations.

4

Register the integration via POST /api/venues/:id/integrations with connector_type "meraki".

5

Optionally configure CMX webhook: Network > Alerts > Webhooks > Add HTTP server pointing to your /ingest endpoint.

Webhook / polling format

meraki-webhook.json
{
  "version": "3.0",
  "secret": "your_webhook_secret",
  "type": "DevicesSeen",
  "data": {
    "networkId": "N_686235993220609594",
    "observations": [
      {
        "clientMac": "aa:bb:cc:dd:ee:ff",
        "seenTime": "2026-03-15T14:23:01Z",
        "ssid": "Guest-WiFi",
        "rssi": 42,
        "ipv4": "10.0.1.45",
        "location": {
          "lat": 40.7128,
          "lng": -74.0060
        }
      }
    ]
  }
}

Normalized canonical event

After normalization, the connector output becomes a standard GNCanonicalEvent:

canonical-event.json
{
  "event_type": "device_connected",
  "venue_id": "v_7213ed41",
  "zone_id": null,
  "device_hash": "hmac_sha256_a1b2c3d4e5f6",
  "timestamp": "2026-03-15T14:23:01.000Z",
  "connector_type": "meraki",
  "metadata": {
    "signal_strength": -42,
    "ssid": "Guest-WiFi",
    "network_id": "N_686235993220609594"
  }
}

Next steps