> ## 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 HPE GreenLake to Neo

> Create an HPE GreenLake API client for the GreenLake platform, save it in Neo, and turn HPE GreenLake on per agent

You connect HPE GreenLake once at the MSP level, with a personal API client of your GreenLake workspace. If you run GreenLake in MSP mode, create it in your MSP workspace, so Neo can act in each customer's tenant workspace.

## What you need first

* An HPE GreenLake workspace that holds your customers' HPE devices. HPE returns warranty and support coverage only for devices in a workspace; Neo can add a device by its serial number and product number.
* A GreenLake user whose role can view devices and subscriptions. The API client acts with that user's role, so give it a role that may do what your agents should do.
* If your workspace has **IP access rules** turned on, add Neo's addresses from [IP whitelisting](https://docs.neoagent.io/integrations/ip-whitelisting.md). GreenLake refuses a call from any other address, even with a valid token.

## 1. Create a personal API client

**1. Open Personal API clients**

Sign in to [HPE GreenLake](https://common.cloud.hpe.com) with your MSP workspace (or your workspace, if you do not run MSP mode), and open **Manage Workspace > Personal API clients**.

**2. Create the client**

Click **Create Personal API client**, name it Neo, and choose **HPE GreenLake Platform** as the service.

**3. Copy the values**

Copy the **Client ID**, the **Client Secret** (GreenLake shows it only once) and the **Issuer URL**. The Issuer URL ends with your workspace ID.

## 2. Add the client in Neo

**1. Open Integrations**

In the Neo Dashboard, open **Integrations** and find the HPE GreenLake card, under Servers & Virtualization (it also lists under Customer Success).

**2. Save the client**

Paste the **Client ID** and **Client Secret**, and paste the **Issuer URL** or the workspace ID into **Workspace ID**. Click **Save**. Neo asks GreenLake for a token with them before saving, so a wrong value is rejected straight away.

After the next PSA metadata sync, check the **Organization Mapping** tab: confirm each tenant workspace's company there. A workspace that does not run MSP mode has no tenants, and the tab stays empty.

## 3. Turn HPE GreenLake on per agent

Open the agent, go to its **Tools & Settings** tab, click **Servers & Virtualization**, and expand the **HPE GreenLake** block. Pick one of its **Presets** (Read Only, Helpdesk, IT Admin, Full Automation), or set each group yourself. A warranty report or a lifecycle dashboard needs only **Devices & Warranty** at Read Only. See [HPE GreenLake API](https://docs.neoagent.io/agents/tools/networking/hpe-greenlake-api.md) for what each group covers.

## Set up an agent

Ask your Neo Support Agent for the agent you need, for example: "Set up a scheduled agent that lists, per customer, the HPE servers and switches whose HPE support ends next quarter, read-only, and marks any device HPE gives no coverage for as not verified."


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