Skip to main content
This guide walks you through connecting your Cisco Meraki Dashboard to MSPortal.ai so network devices sync automatically into your device inventory.

​
Overview

Cisco Meraki is a cloud-managed networking platform for access points, switches, security appliances, cameras, and sensors. By integrating Meraki with MSPortal.ai, you can:
  • Sync network devices from all your Meraki organizations into MSPortal’s device inventory
  • Map Meraki organizations to the correct MSPortal companies
  • Assign Meraki networks to company locations so devices land in the right place
  • Keep device details like model, serial number, firmware version, and IP address current
  • Classify Meraki hardware into your own device types (firewalls, switches, access points, and more)

​
Prerequisites

  • Cisco Meraki Dashboard account with organization admin access
  • Dashboard API access enabled for your Meraki organization
  • MSPortal.ai account with integration management permissions

​
Part 1: Generate a Meraki API Key

Before connecting to MSPortal.ai, you need a Meraki Dashboard API key.
1

Log into the Meraki Dashboard

Access your dashboard at dashboard.meraki.com.
2

Enable Dashboard API Access

Go to Organization > Settings and scroll to the Dashboard API access section.Check Enable access to the Cisco Meraki Dashboard API and save.
If you manage multiple Meraki organizations, enable API access in each organization you want to sync.
3

Generate the API Key

Open your profile by clicking your account name in the top-right corner, then select My profile.In the API access section, click Generate new API key.
Newer Meraki dashboards also offer API key management under Organization > Configure > API & webhooks. Either location produces a valid key.
4

Copy the API Key

Copy the key immediately.
Store the API key securely! Meraki only shows the key once. If you lose it, generate a new one.
The key inherits the permissions of your Meraki account. Devices sync from every organization the key can access, so a dedicated read-only Meraki admin account is a good choice for generating the key.

​
Part 2: MSPortal Setup

Meraki is configured through a settings panel rather than a multi-step wizard. You connect the API key once for your whole tenant, then map organizations and device types.

​
Connect the API Key

1

Navigate to Integrations

In MSPortal.ai, go to Settings > Integrations.
2

Find Cisco Meraki

Locate the Cisco Meraki integration card and click Connect to open the Meraki settings panel.
3

Configure the API Key

Click Configure API Key.In the Configure Meraki API Key dialog, paste your key into the API Key field and click Connect.
Your API key is encrypted and stored securely. It is used to sync device information from all organizations accessible with the key.
4

Review the Configuration

After connecting, the panel shows your configuration:

​
Map Organizations

Map each Meraki organization to an MSPortal company. Only devices from mapped organizations are imported.
1

Open Organization Mappings

In the Meraki settings panel, click Map Organizations.
2

Use Quick Match

Click Quick Match to automatically match Meraki organizations to MSPortal companies based on name similarity. Review the results and adjust as needed.
3

Map Manually

For organizations that were not matched automatically:
  1. Find the organization in the list
  2. Click the Select company dropdown in the “Mapped To” column
  3. Search for and select the correct MSPortal company
Use the filter to view All Organizations, Mapped Only, or Unmapped Only. The View in Meraki link opens the organization in the Meraki Dashboard.

​
Device Type Mappings

Control how Meraki product types are classified in your device inventory.
1

Open Device Type Mappings

In the Meraki settings panel, click Device Type Mappings.
2

Review and Adjust Mappings

Each Meraki product type (wireless, appliance, switch, camera, cellular gateway, sensor, and others) can be mapped to one of your MSPortal device types.Sensible defaults are applied automatically, for example: appliances map to Firewalls, switches to Switches, and wireless devices to Access Points. Adjust any mapping to fit your own device type structure.

​
Run the First Sync

1

Sync All Companies

Back in the Meraki settings panel, click Sync All Companies to pull devices from every mapped organization.
2

Verify Devices

Once the sync completes, open the Devices page for a mapped company and confirm the Meraki hardware appears with the expected device types.

​
Company-Level Setup (Optional)

In addition to the tenant-wide API key, individual companies can connect their own Meraki access and choose exactly which networks sync.
1

Open the Company

Go to Settings > Companies and select a company.
2

Connect Meraki for the Company

Find the Device Integrations section and locate the Cisco Meraki card.Click Connect to authorize through Meraki’s sign-in popup, or choose Use API Key to enter a Meraki API key for this company.
3

Select the Organization and Networks

Choose which Meraki organization belongs to this company, then select the specific networks to sync.
4

Map Networks to Locations

Click Map Networks to Locations to assign each Meraki network to a company location. Devices are automatically associated with these locations when synced.
Locations must already exist in the company’s settings before they can be assigned to networks.
5

Manage the Company Integration

From the company’s Meraki card you can also use Sync Now, Pause Sync / Resume Sync, and Remove Integration.

​
What Gets Synced

The Meraki integration syncs the following data to MSPortal:

​
Organizations and Networks

  • Organization names and dashboard links
  • Networks within each organization, including their product types

​
Devices

Network hardware from mapped organizations:
  • Device name
  • Serial number
  • MAC address
  • Model
  • Firmware version
  • IP address
  • Product type, classified into your MSPortal device types

​
Synchronization Schedule

After initial setup, data syncs automatically: Each integration syncs at most once every 24 hours on the schedule. Manual syncs are not limited by this interval.
You can trigger a manual sync at any time with Sync All Companies in the tenant-wide settings, or Sync Now on a company’s Meraki card.

​
Managing Your Integration

After setup, manage the integration from Settings > Integrations by opening the Cisco Meraki card:

​
Troubleshooting

​
Security & Privacy

  • API Key Storage: Your Meraki API key is encrypted and never exposed in logs or responses
  • Data Isolation: All synced data is tenant-isolated and only visible to your organization
  • Read-Only Usage: MSPortal only reads device and network information; it never changes your Meraki configuration

​
Next Steps

After setting up the Meraki integration:

View Devices

Browse the synced network hardware in your device inventory

Import Devices

Learn how device imports work across integrations

Sync Schedules

See when each integration refreshes its data

Other Integrations

Explore additional integration options

​
Need Help?

For assistance with the Cisco Meraki integration, contact support@msportal.ai.