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/docs/api-reference/marketing-marketing-emails-v3/marketing-emails/get-marketing-v3-emails-
Check your code
bash
npx shapi-cli scan .shapi scan lists the call sites this change affects; shapi fix repairs them test-first when the advisory has an automatic fix. All advisories · Markdown · OSV · JSON