Cisco Meraki Service Graph Connector API Endpoints

  • Release version: Zurich
  • Updated June 16, 2026
  • 2 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Cisco Meraki Service Graph Connector API Endpoints

    The Cisco Meraki Service Graph Connector integrates Cisco Meraki Dashboard API data into the ServiceNow AI Platform® Configuration Management Database (CMDB). This integration enables ServiceNow customers to synchronize detailed network, device, and connectivity information from Meraki into their CMDB, enhancing visibility and management of network infrastructure within ServiceNow.

    Show full answer Show less

    API Endpoints and Data Flow

    The connector uses several key API endpoints to retrieve and update data about organizations, networks, devices, device statuses, uplink statuses, switch ports, and device inventory. Each endpoint provides specific structured data that populates corresponding CMDB tables and supports operational insights.

    • Organizations Endpoint: Retrieves organizational details including MSP ID, customer number, and API IP restriction mode, enabling ServiceNow to identify and manage Meraki organizations.
    • Networks Endpoint: Provides network identifiers and descriptions within an organization, allowing mapping of network segments in the CMDB.
    • Devices Endpoint: Delivers detailed device information such as serial number, model, MAC address, firmware version, location (latitude/longitude), and device notes, supporting comprehensive device asset tracking.
    • Device Statuses Endpoint: Reports real-time status of devices including online status, public and WAN IP addresses, gateway, and DNS settings, enabling monitoring of device connectivity.
    • Uplink Statuses Endpoint: Supplies uplink configuration and status data for devices, including interface status, IP details, high availability role, and cellular information, assisting in network path and redundancy management.
    • Switch Ports Endpoint: Provides status of individual switch ports (connected or disconnected) per device, facilitating detailed port-level visibility within ServiceNow.
    • Device Inventory Endpoint: Shares inventory metadata such as order numbers and license expiration dates, supporting lifecycle and compliance tracking in the CMDB.

    Practical Benefits for ServiceNow Customers

    By leveraging these API endpoints, ServiceNow customers can:

    • Automatically synchronize Meraki network and device data into the ServiceNow CMDB for accurate asset and configuration management.
    • Gain real-time insights into device connectivity and operational status to support incident and problem management.
    • Track switch port statuses and uplink configurations to enhance network troubleshooting and change planning.
    • Monitor inventory details such as license expirations to maintain compliance and plan renewals effectively.

    This integration streamlines network infrastructure management within ServiceNow, improving accuracy and operational efficiency for IT teams managing Cisco Meraki environments.

    The Service Graph Connector for Meraki integrates Cisco Meraki Dashboard API data into ServiceNow AI Platform®Configuration Management Database (CMDB). This document details the API endpoints used and how data flows through the system.

    Table 1. Organizations endpoint
    Description Endpoint
    Organizations API response

    URL:/organizations

    		 
    {                                                                    │
│    "id": "123456",                                                    │
│    "name": "My Organization",                                         │
│    "management": {                                                    │
│      "details": {                                                     │
│        "MSP ID": "...",                                               │
│        "customer number": "...",                                      │
│        "IP restriction mode for API": "..."                           │
│      }                                                                │
│    }                                                                  │
│  }
    Table 2. Networks Endpoint
    Description Endpoint
    Networks API response

    URL:/organizations/{orgId}/networks

    		 
    {                                                                    │
│    "id": "N_123456",                                                  │
│    "organizationId": "123456",                                        │
│    "name": "My Network",                                              │
│    "notes": "Network description"                                     │
│  }
    Table 3. Devices Endpoint
    Description Endpoint
    Devices API response

    URL: /organizations/{orgId}/devices

    		 
    {                                                                    │
│    "serial": "Q2XX-XXXX-XXXX",                                        │
│    "name": "My Device",                                               │
│    "networkId": "N_123456",                                           │
│    "model": "MX68",                                                   │
│    "mac": "00:11:22:33:44:55",                                        │
│    "productType": "appliance",                                        │
│    "firmware": "mx-18.1",                                             │
│    "lat": 37.7749,                                                    │
│    "lng": -122.4194,                                                  │
│    "address": "123 Main St",                                          │
│    "notes": "Device description"                                      │
│  }
    Table 4. Device statuses endpoint
    Description Endpoint
    Devices statuses API response

    URL: /organizations/{orgId}/devices/statuses

    		 
    {                                                                    │
│    "serial": "Q2XX-XXXX-XXXX",                                        │
│    "status": "online",                                                │
│    "publicIp": "203.0.113.1",                                         │
│    "wan1Ip": "192.168.1.1",                                           │
│    "wan2Ip": "192.168.2.1",                                           │
│    "wan1Gateway": "192.168.1.254",                                    │
│    "wan1IpType": "dhcp",                                              │
│    "wan1PrimaryDns": "8.8.8.8",                                       │
│    "wan1SecondaryDns": "8.8.4.4"                                      │
│  }
    Table 5. Uplink statuses endpoint
    Description Endpoint
    Uplink statuses endpoint

    URL: /organizations/{orgId}/uplinks/statuses

    		 
    {                                                                    │
│    "serial": "Q2XX-XXXX-XXXX",                                        │
│    "networkId": "N_123456",                                           │
│    "model": "MX68",                                                   │
│    "highAvailability": {                                              │
│      "enabled": true,                                                 │
│      "role": "primary"                                                │
│    },                                                                 │
│    "uplinks": [                                                       │
│      {                                                                │
│        "interface": "wan1",                                           │
│        "status": "active",                                            │
│        "ip": "192.168.1.1",                                           │
│        "gateway": "192.168.1.254",                                    │
│        "publicIp": "203.0.113.1",                                     │
│        "primaryDns": "8.8.8.8",                                       │
│        "secondaryDns": "8.8.4.4",                                     │
│        "ipAssignedBy": "dhcp"                                         │
│      },                                                               │
│      {                                                                │
│        "interface": "cellular",                                       │
│        "status": "ready",                                             │
│        "apn": "broadband",                                            │
│        "iccid": "...",                                                │
│        "imsi": "...",                                                 │
│        "msisdn": "..."                                                │
│      }                                                                │
│    ]                                                                  │
│  }
    Table 6. Switch ports endpoint
    Description Endpoint
    Switch ports endpoint

    URL: /organizations/{orgId}/switch/ports/statuses/bySwitch

    		 
    {                                                                    │
│    "items": [                                                         │
│      {                                                                │
│        "serial": "Q2XX-XXXX-XXXX",                                    │
│        "network": { "id": "N_123456" },                               │
│        "ports": [                                                     │
│          {                                                            │
│            "portId": "1",                                             │
│            "status": "connected"                                      │
│          },                                                           │
│          {                                                            │
│            "portId": "2",                                             │
│            "status": "disconnected"                                   │
│          }                                                            │
│        ]                                                              │
│      }                                                                │
│    ]                                                                  │
│  }
    Table 7. Device inventory endpoint
    Description Endpoint
    Device inventory endpoint

    URL: /organizations/{orgId}/inventory/devices

    		 
     {                                                                    │
│    "serial": "Q2XX-XXXX-XXXX",                                        │
│    "orderNumber": "ORD-12345",                                        │
│    "licenseExpirationDate": "2025-12-31"                              │
│  }