> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neoagent.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecting Tier2Tickets to Neo

> Create a Tier2Tickets API key and save it in Neo

You connect Tier2Tickets once at the MSP level. Neo reaches the endpoint groups and permissions you give the key.

## 1. Create an API key

**1. Open API credentials**

Sign in at [account.helpdeskbuttons.com/api-credentials](https://account.helpdeskbuttons.com/api-credentials). Your website account needs the permission to manage API credentials.

**2. Name the key and pick its permissions**

Name it for Neo. Pick the permissions the jobs you want need:

| Permission | Lets Neo |
| - | - |
| **view-endpoints** | Read PCs and groups. Required: Neo checks the key with it |
| **report-history** | List diagnostic reports |
| **report-diagnostics** | Read a report's details and diagnostics |
| **generate-report** | Ask a PC for a new diagnostic report |
| **run-command** | Show a toast or popup, rename the desktop icon, pin the button to the taskbar |
| **change-group** | Move a PC to another group |
| **upgrade-endpoints** | Upgrade a PC's agent |

Neo cannot read Instant Replay screenshots, so it needs no **view-instant-replay**.

**3. Pick the groups**

Pick **ALL** for every client, or only the groups Neo may reach.

**4. Copy the key**

Copy the key before you leave the page: it shows only once.

## 2. Add the key in Neo

**1. Open Integrations**

In the Neo Dashboard, open **Integrations** and find the Tier2Tickets card, under Customer Success.

**2. Save the key**

Paste the API key and click **Save**. Neo lists your groups with it before saving, so a wrong key, or a key without **view-endpoints**, is rejected straight away.

**3. Check the mapping**

Open the card's **Organization Mapping** tab and confirm each group's company.

## 3. Turn Tier2Tickets on per agent

Open the agent, go to its **Tools & Settings** tab, click **Customer Success**, and expand the **Tier2Tickets** block. Pick a preset or set each area:

| Area | Access levels you can pick | Notes |
| - | - | - |
| **Endpoints and Groups** | Disabled, Read Only, Read / Write | Read PCs and groups. Writes rename the desktop icon, pin the button, move a PC to another group or upgrade its agent. |
| **Diagnostic Reports** | Disabled, Read Only, Read / Write | Read the reports a button press files. A write asks an online PC for a new report. |
| **End-User Messages** | Disabled, Read / Write | Show a toast or a popup on the user's screen. A popup with a link always asks a technician. |

The **Read Only** preset reads PCs and reports. **Helpdesk** turns every area on and asks a technician before each action. **Full Automation** acts without approval, apart from a popup with a link. See [Tier2Tickets API](https://docs.neoagent.io/agents/tools/sales/tier2tickets-api.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.