Upcoming Sunset of the Contact Lists API: What You Need to Know

HubSpot will officially retire the Contacts Lists API on May 30, 2025, as part of the transition to the V3 Lists API. If your team relies on this API to manage lists, it’s time to start migrating to the new version to avoid disruptions.

Why This Matters

The V3 Lists API is designed to better align with the HubSpot Lists app experience, offering more functionality and a streamlined workflow. Once the Contact Lists API is deprecated, all endpoints will return 404 errors, meaning any integrations still relying on the old API will break.

For businesses using HubSpot’s API for contact list management, this means a critical update is required to maintain seamless functionality.

Which Endpoints Are Affected?

As of May 30, 2025, the following API requests will be deprecated:

• Creating, retrieving, updating and deleting contact lists
• Adding or removing contacts from lists
• Fetching contacts from lists (including recent additions)
• Fetching static and dynamic lists
• Contact list memberships from specific V1 Contacts API endpoints

For a full breakdown of impacted endpoints, refer to HubSpot’s V3 Lists API documentation here for migration guidance.

What Should You Do Next?

If your team or developers rely on the Contact Lists API, you’ll need to:

1. Review the affected endpoints and identify which integrations will be impacted.
2. Update your API calls to use the new V3 Lists API before the sunset date.
3. Test your integrations to ensure a smooth transition and avoid disruptions.
4. Work with a HubSpot expert to optimize your API usage for better performance.

Who Is Affected?

This change applies to all HubSpot accounts and tiers, so whether you're a small business or an enterprise, it’s crucial to update your API usage before the deadline.

Need Help with the Transition?

At Antidote 71, we help businesses navigate HubSpot’s evolving ecosystem—ensuring your integrations remain functional and optimized. If you need assistance updating your API connections or improving your HubSpot workflows, let’s talk.