Important security notice: Meraki has a security issue when you have access to more than one Meraki Customer. Because the API token is tied to a user account, and not to the accessed Meraki Customer, using your own personal API token is not appropriate.

For this reason, we strongly recommend that you create a dedicated "ReportMagic" user in your own domain (e.g. reportmagic@mymsp.com) and provide that user with access to only the required Meraki customers. You will also need to set up an API key for this user, which you can do by:

1. In the top left hand corner of ReportMagic, click your profile picture.
2. Under API Tokens, click My API Tokens.
3. Click the Create button to enter the name, key and description for your dedicated API Token.

Meraki Macros

ReportMagic has Meraki macros which provide information available via Meraki API calls.

To use [Meraki.XXX:] macros, set up a Meraki connection as follows:

1. From the Admin menu, click Connections.
2. Click the Create button.
3. From the Type drop-down, select a Connection type of Meraki.
4. Enter a name - we recommend that you use "Default" for the name of the first connection of each type, and optionally, a description.
5. In the URL field, enter the API URL, for example, https://api.meraki.com
6. In the User name field, enter N/A  (as a value is required, but is ignored).
7. In the Password field, enter one of the user's API Keys.
8. If you need to provide advanced configuration, for example to specify a region or apply rate limiting, you can use the Configuration field.  See below for an example for using the China region and to ensure that Meraki DataMagic makes no more that 100 calls are made within 60 seconds.
9. Click Save.

Example Configuration

{
  "ApiRegion": "China",
  "RateLimitMaxCalls": 100,
  "RateLimitTimeSpanSeconds": 60
}