Skip to content
HubSpot Developer Changelog

Marketing Email API Migration to ILS Lists


With the migration process from List IDs to ILS List IDs, the Marketing Email API is being updated to include the ILS List ID in the response and accept ILS IDs in the request. On October 31st, 2024 the contactLists object will no longer function and will be removed from Marketing Email API calls.

What's Changing?

We are updating the Marketing Email API endpoints to include both the contactListId and the contactIlsId. During the migration process, you should expect this pattern with regards to contact lists:

// JSON snippet { "contactIds": { "exclude": [], "include": [] }, "contactIlsLists": { "exclude": [], "include": ["25"] }, "contactLists": { "exclude": [], "include": ["17"] } }

 

When Is This Happening?

This functionality is available now. Developers can expect both IDs until October 31st, 2024. After this date, contactLists IDs will be removed and will no longer be functional.

Questions or Feedback?

We encourage you to share your thoughts and queries in the developer forums.