> ## 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 HP Warranty to Neo

> Get an HP Warranty API key, save it in Neo and turn it on for your agents and dashboards

You connect HP Warranty once at the MSP level, then turn it on per agent or dashboard.

## 1. Get an HP Warranty API key

HP gives access to its Warranty API on request.

**1. Request access**

Sign in to the [HP Developers Portal](https://developers.hp.com) and request access to the HP Warranty API for your company. If you do not get an answer, write to [warrantyapi.customers@hp.com](mailto:warrantyapi.customers@hp.com) or ask your HP account manager.

**2. Copy the key and secret**

When HP approves the app, copy its **API Key** (also called Client ID) and **API Secret** (Client Secret).

## 2. Add the key in Neo

**1. Open Integrations**

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

**2. Save the key**

Paste the API Key and the API Secret and click **Save**. Neo signs in to HP with them before saving, so a wrong key, or an app HP has not approved yet, is rejected straight away.

## 3. Turn HP Warranty on

Open the agent, go to its **Tools & Settings** tab, click **Customer Success**, and expand the **HP Warranty** block. Pick the **Read Only** profile, or set **Warranty Lookups** to Read Only. For a dashboard, turn on HP Warranty in the dashboard's integrations the same way.

| Area | Access levels you can pick | Notes |
| - | - | - |
| **Warranty Lookups** | Disabled, Read Only | Look up the coverage of HP devices by serial number. HP has nothing to write. |

## Serial numbers and product numbers

Neo takes the serial numbers from your PSA's configuration items or your RMM's device audit. HP matches most devices on the serial number alone. For some it also needs the HP product number (like `2U740AV`), which is on the device's label. A device HP cannot match shows as not verified; add its product number to the configuration item and check again.

## Example: a lifecycle dashboard

Ask Neo Support to extend your lifecycle dashboard like this:

> For each HP device that is not a workstation, check its warranty with HP on every refresh. Show the coverage, the end date, the source and the check time. Show a device HP could not check as not verified.

See [HP Warranty API](https://docs.neoagent.io/agents/tools/sales/hp-warranty-api.md) for what an agent can read.


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