{
  "schema_version": "1.7.0",
  "id": "x_SHAPI-hubspot-marketing-emails-folderid-removed",
  "modified": "2026-10-31T01:29:34Z",
  "published": "2025-10-30T00:00:00Z",
  "summary": "Marketing Email v3 stopped returning folderId on 2026-01-28",
  "details": "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.\n\nRead 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.",
  "affected": [
    {
      "ecosystem_specific": {
        "provider": "hubspot",
        "endpoint": {
          "method": "GET",
          "path": "/marketing/v3/emails/**"
        },
        "change_class": "field-rename",
        "trigger": {
          "fields": [
            "folderId",
            "results[].folderId"
          ]
        },
        "effective_date": "2026-01-28",
        "recipe": "apply-fix"
      }
    }
  ],
  "references": [
    {
      "type": "ADVISORY",
      "url": "https://developers.hubspot.com/changelog/marketing-email-api-folder-id-migration"
    },
    {
      "type": "WEB",
      "url": "https://developers.hubspot.com/docs/api-reference/marketing-marketing-emails-v3/marketing-emails/get-marketing-v3-emails-"
    }
  ],
  "database_specific": {
    "severity": "high",
    "status": "verified",
    "url": "https://shapi.dev/osv/hubspot-marketing-emails-folderid-removed.json"
  }
}