# Meraki

## Overview

Use the Meraki integration to identify problems with your users and licenses before they occur. Integrating with Meraki enables you to build boards that correlate fields within Meraki and with other connected tools. You can also run actions on fetched data without ever leaving Stitchflow.

#### Generate API key

1. Ensure that the **Organization** > **Settings** > **API Access** option is set to “**Enable access to the Cisco Meraki Dashboard API**”
2. Proceed to the **avatar icon** (on the top-right of the green ribbon) > **My profile** page to generate an API key. This API key will be associated with the dashboard administrator account which generates it, and will inherit the same permissions as that account. You can generate, revoke, and regenerate your API key on your profile

## Configure

Enable the Meraki integration from `Connections` in the left sidenav. Click `Connect` and enter your API key. Before connecting, Meraki will sync for a few minutes while fetching data. Once connected, you can click the `...` menu on the Meraki integration tile to manage or disconnect the integration.&#x20;

### Manage permissions

Meraki actions allow you to run operations on fetched data without ever leaving Stitchflow. All actions are enabled by default and will be accessible on every board, but can be disabled by clicking the `...` menu and selecting `Remove connection`.

{% hint style="info" %}
Please note that disconnecting Meraki will also permanently delete any boards in which it is used.
{% endhint %}

## Data model

We automatically fetch and relate the following objects from Meraki resources.

<details>

<summary>Supported objects</summary>

* Admins
* Devices
* Licenses
* Organizations
* Organization Devices
* Networks

</details>

We support the following actions in Meraki.

<details>

<summary>Supported actions</summary>

* Create org admin
* Delete org admin
* Remove network device
* Claim network device
* Create org network
* Create org
* Assign org license seats
* Move org licenses
* Move org license seats
* Renew org license seats

</details>

## Boards

When building a board, you can select any supported Meraki resource as your object to indicate the data you want to surface on your board. We automatically determine the primary field for each object. The primary field is meant to be a unique representation of each record in a board.&#x20;

{% hint style="info" %}
An object in Stitchflow is a data type that is used to treat several different pieces of data as one unit.
{% endhint %}

### Adding fields

Click `Add field` to select fields from both within Meraki and across your other connected tools. We only show fields that can be joined with your chosen object.&#x20;

### Triggering actions

Click `Integration actions` in the top right of any board to view all available actions across your connected integrations. When selecting an action, you'll be prompted to fill out all required inputs necessary to run the action. Changes and updates made via actions will persist to all boards.

{% hint style="info" %}
Stitchflow fetches Meraki data every 24 hours.
{% endhint %}
