---
module: msp.institution-keys
title: Institution Keys
tab: Customer
order: 10
audience: customer
---

Institution Keys link a short institution code to the full institution name your devices use. Use this screen when you add a new institution, correct a name, or control which kinds of devices are allowed to connect.

## 🔎 Find a Mapping
1. Use the **Search** box to filter by key code or institution name.
2. Toggle **Auto-refresh** to keep the list current, or click the **↻** refresh button to update it now.

## ➕ Add a Mapping
1. Click **+ Add Mapping** in the toolbar.
2. Enter the **Key** — a short code of 2–10 uppercase letters (e.g. `AICU`).
3. Enter the **Institution Name** exactly as it appears on your devices — this is case-sensitive and must match precisely.
4. Choose the **Supported Device Types** (ATM, TCR, or both).
5. Click **Add Mapping** to save.

## ✏️ Edit a Mapping
1. Click **Edit** on any row.
2. Update the institution name or the supported device types.
3. Click **Save Changes**.

> The key code itself can't be changed after a mapping is created — only the name and device types.

## 🗑️ Delete a Mapping
1. Click **Delete** on the row you want to remove.
2. Confirm in the pop-up.

> Deleting a mapping means users tied to that key will no longer see any devices until a new mapping is created. Remove one only when you're sure it's no longer in use.

## 📋 What You're Looking At
- **Key** — the short institution code.
- **Institution Name** — the full name devices are registered under.
- **Device Types** — the kinds of devices allowed to connect (ATM, TCR, or both).

> Good to know: the device name must match exactly. If a device connects with a device type that isn't listed here, its registration is turned away — so double-check the name and device types when a new device won't come online.
