Following up on our recent updates for the Marketing Email API, we're updating the system used for the folder structure system used for marketing emails. This v2 folder system will replace the folderIds returned with both the new v3 API and the v1 Marketing Email API that is being sunset.
What's changing?
A new folderIdV2 field has been added to the Marketing Email v3 API. This field will be returned along with the folderId that was originally returned with the v1 API. If your integration uses the email folders, you'll need to update your folder index to replace the older folderId with the updated folderIdV2.
You can get all of the folders by using the Marketing Email v3 API and including the folderId__not_null query parameter to only retrieve emails that are in folders, and parsing the response for the folderId and folderIdV2 for each returned email.
Both ID fields will be returned together, until the folderId is removed on January 28, 2026. After this, only the folderIdV2 field will be returned.
Please let us know if you have any questions by joining the discussion in our community.