# Marketing Email API folder ID Migration

**URL:** <https://community.hubspot.com/t/marketing-email-api-folder-id-migration/141837>\
**Category:** Developer Announcements\
**Tags:** api, announcement\
**Created:** [October 30, 2025, 4:08pm UTC](https://community.hubspot.com/t/marketing-email-api-folder-id-migration/141837 "2025-10-30T16:08:37Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![Dadams](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/dadams/32/21752_2.png) [@Dadams](https://community.hubspot.com/u/Dadams)\
**Post date:** [October 30, 2025, 4:08pm UTC](https://community.hubspot.com/t/marketing-email-api-folder-id-migration/141837/1 "2025-10-30T16:08:37Z")

</div>

Following up on our [recent updates for the Marketing Email API](https://developers.hubspot.com/changelog/marketing-email-api-v3-released-to-general-availability-and-upcoming-sunset-for-v1), 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](https://developers.hubspot.com/docs/api-reference/marketing-marketing-emails-v3/guide) and the [v1 Marketing Email API that is being sunset](https://developers.hubspot.com/changelog/marketing-email-api-v3-released-to-general-availability-and-upcoming-sunset-for-v1).

### What’s changing?

A new `folderIdV2` field has been added to the [Marketing Email v3 API](https://developers.hubspot.com/docs/api-reference/marketing-marketing-emails-v3/guide). 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](https://developers.hubspot.com/docs/api-reference/marketing-marketing-emails-v3/marketing-emails/get-marketing-v3-emails-) 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 replying below.

---

<div class="post-metadata">

**Author:** ![Jaycee\_Lewis](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/jaycee_lewis/32/61352_2.png) [@Jaycee\_Lewis](https://community.hubspot.com/u/Jaycee_Lewis)\
**Post date:** [October 30, 2025, 4:18pm UTC](https://community.hubspot.com/t/marketing-email-api-folder-id-migration/141837/2 "2025-10-30T16:18:16Z")

</div>

Thank you for the update @Dadams 🙌