What you'll need
- An HP business relationship — the Warranty API is for HP commercial customers and partners. HP reviews and approves access requests; it is not open self-serve.
- An API key and API secret — a credential pair you create in a Tech Group on the HP Developers portal once your access is approved.
1. Request HP Warranty API access
Access to the Warranty API is reviewed by HP’s customer advocacy group together with your HP account manager.
- Email warrantyapi.customers@hp.com to request access. Include your company details and your HP account information so HP can validate the request.
- Once HP approves, your account is added to a Tech Group on the HP Developers portal (developers.hp.com).
2. Create your API credentials
- Sign in to developers.hp.com.
- On the portal home, find the My HP area — it lists the Tech Groups you belong to. Open your warranty Tech Group’s tile.
- On the Tech Group page, click Get Credentials. The portal generates an API key and an API secret.
- Copy both values. The secret is shown alongside the key when the credential is created — store it somewhere safe.
3. Add the credentials to Vectis
- Go to Admin → Integrations and click Configure on HP / HPE warranty lookup.
- Paste the API Key and API Secret from the HP Developers portal. Both are encrypted at rest.
- Save and make sure the connector is enabled.
4. Run the enrichment
Open Asset lifecycle → Refresh pipeline and click Enrich warranties — the same button runs every configured vendor connector, HP included. HP looks devices up by serial number. A product number, when Vectis has one on the asset, makes the match more precise — a serial alone can map to several HP SKUs. Vectis sends both when available, in batches of up to 50 devices per call, and writes back for each asset:
warranty_expiry— the latest-ending warranty offer HP returns for that device.warranty_provider— the description of that warranty offer (for example, the Care Pack tier).
Common errors
HP warranty credentials not configured — No credentials are saved, or the connector is disabled. Add the API key and secret under Admin → Integrations and enable the connector.
OAuth token exchange failed — The API key or secret is wrong, or the credential is not authorized for the warranty scope. Re-check both values, and confirm with HP that your warranty API access was approved.
Assets reported as “not found” — HP has no warranty record for that serial. This is normal for very old hardware and for devices whose serial was entered incorrectly in the source system. Adding the product number to the asset can also improve match rates.