# Marketing Email v3 stopped returning folderId on 2026-01-28

- **Provider:** HubSpot
- **Endpoint:** `GET /marketing/v3/emails/**`
- **Effective:** 2026-01-28
- **Severity:** high
- **Change:** field-rename
- **Status:** verified
- **Automatic fix:** `apply-fix`

## What changed

HubSpot moved marketing email folders to a v2 folder system and added folderIdV2 to Marketing Email v3 responses. Both fields were returned side by side until folderId was removed on 2026-01-28; since then only folderIdV2 is returned, so code keyed on folderId gets no folder value.

## What to do

Read folderIdV2 instead of folderId from /marketing/v3/emails responses and re-key any stored folder index on folderIdV2 (list emails with folderId__not_null to rebuild it); old folderId values no longer match anything the API returns.

## Sources

- Provider notice (2025-10-30): https://developers.hubspot.com/changelog/marketing-email-api-folder-id-migration
- https://developers.hubspot.com/docs/api-reference/marketing-marketing-emails-v3/marketing-emails/get-marketing-v3-emails-

## Machine-readable

- Advisory: https://github.com/SriVarshini09/shapi-advisories/blob/main/advisories/hubspot-marketing-emails-folderid-removed.json
- OSV: https://shapi.dev/osv/hubspot-marketing-emails-folderid-removed.json