---
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 to review mappings, correct a name, or control which kinds of devices are allowed to connect.

> **⚠️ Only BCOS can add an institution.** MSP and customer admins can view and edit existing mappings, but **cannot create or delete institutions** — you won't see the **+ Add Mapping** or **Delete** buttons. **To have a new institution added (or an existing one removed), submit a request to BCOS.**

## 🔎 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.

## ➕ Adding a New Institution (BCOS only)
Creating a new institution is handled by **BCOS**, so there is no **+ Add Mapping** button on this screen for MSP or customer admins. **Submit a request to BCOS** with:
- the **Key** you want — a short code of 2–10 uppercase letters (e.g. `AICU`),
- the **Institution Name** exactly as it appears on your devices (case-sensitive, must match precisely),
- the **Supported Device Types** (ATM, TCR, or both).

Once BCOS creates the mapping, you can edit its name and device types here.

## ✏️ 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.

## 🗑️ Removing an Institution (BCOS only)
Deleting an institution is also a **BCOS-only** action — **submit a request to BCOS**. Removing a mapping means users tied to that key can no longer see any devices, so BCOS removes one only when it is confirmed 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.
