Step 1: Connect with Cisco Meraki

Cisco Meraki
Documentation/Getting Started/Step 1: Connect with Cisco Meraki

Connect with Cisco Meraki

QuuPass uses Cisco's official OAuth 2.0 Authorization Code flow to connect to your Meraki organization. You approve access directly in your Cisco dashboard — no API key is required and no credentials are ever shared with QuuPass.

Before you begin — requirements

  • Administrator-level access or higher in your Cisco Meraki organization. Read-only accounts cannot authorize OAuth scopes that write wireless configuration.
  • At least one SSID already created in your Meraki Dashboard with authentication mode set to Identity PSK without RADIUS. The wizard will detect it automatically.
  • Your Cisco Meraki account credentials (email + password) to log in when redirected.

Administrator or Full Organization Admin required

The Meraki account you authorize with must hold at minimum the Administrator role scoped to the organization you wish to manage. Network-only or read-only roles will cause the authorization to succeed but wireless write operations will be rejected by Cisco.

How to Connect

1. Click “Connect with Cisco Meraki”

On the wizard start screen, click the blue Connect with Cisco Meraki button. QuuPass will generate a signed, time-limited state token and redirect your browser to Cisco's authorization server at as.meraki.com.

2. Log in to your Cisco account

Cisco will ask you to sign in with your Meraki dashboard credentials. This happens entirely on Cisco's domain — QuuPass never sees your username or password.

Use the account that has Administrator (or higher) access to the organization you want QuuPass to manage.

3. Review and approve the requested scopes

Cisco will display the list of permissions QuuPass is requesting. These are the minimum required:

ScopeAccess
dashboard:general:config:readRead
dashboard:general:telemetry:readRead
wireless:config:readRead
wireless:config:writeWrite
wireless:telemetry:readRead

See OAuth 2.0 & Permissions for a full explanation of each scope.

4. You're redirected back to QuuPass

After you approve, Cisco redirects your browser back to QuuPass. The connection is confirmed with a green “Connected via Cisco Meraki” banner and you can proceed to Step 2 — Organization Selection. Tokens are refreshed automatically; you will not need to re-authorize unless you revoke access.

Troubleshooting

Authorization was cancelled or denied

  • • Click Connect with Cisco Meraki again and approve all requested scopes.
  • • Make sure you log in with the correct organization account.

Wireless write operations fail after connecting

  • • Your account may be read-only or network-scoped. Confirm your role is Administrator or Organization Admin in Meraki Dashboard → Organization → Administrators.
  • • Revoke QuuPass access, then reconnect using an account with the correct role.

Redirected to the wrong page or a localhost URL

  • • Ensure you are accessing QuuPass at meraki.quupass.cloud (not a local dev URL).
  • • Contact [email protected] if the issue persists.

Next Steps

Once connected, you'll select the Meraki organization and network for your guest portal.