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 contactList (which include the CLS list IDs) and the contactIlsLists (which include ILS list IDs) in the JSON response during the migration period to allow you to map the contactListId to contactIlsId. Going forward, you should only use the contactIlsList object when submitting requests to this API.

During the migration process, you should expect this pattern with regards to contact lists in the response JSON:

// 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.