# The Contact Lists API v1 stops working

Calls to /contacts/v1/lists* on HubSpot API stopped working on April 30, 2026.

On April 30, 2026, the Contact Lists API v1 was retired. Calls to endpoints matching /contacts/v1/lists* fail since that date.

## What to use instead

Manage lists using the Lists API at /crm/v3/lists or /crm/lists/2026-09.

- API: HubSpot API (api.hubapi.com)
- Kind: Version retirement
- Takes effect: April 30, 2026
- Calls after that day: fail
- Calls it hits: `/contacts/v1/lists*`
- Source: [Announcement](https://developers.hubspot.com/docs/api-reference/deprecated-apis)
- Verified: November 6, 2026, against HubSpot API's own pages
- Page: https://www.okapi.bot/providers/hubspot-api/breaking-changes/the-contact-lists-api-v1-stops-working/

## HubSpot API's words

> Contact lists v1 | April 30, 2026 | Create and manage contact lists with the latest lists API.

Okapi finds the calls this change hits in your repo and opens the pull request with the fix: https://github.com/apps/okapi-agent