Marketing Email API Migration to folderIdV2

Marketing HubSales HubService HubContent HubData HubSmart CRMRevenue HubFreeStarterProfessionalEnterpriseLive

What it is

HubSpot is updating the Marketing Email API endpoints to include both the existing folderId and the new folderIdV2 fields in the JSON response during the migration period to allow you to map the folderId to folderIdV2. folderId is the field that represents the folder containing Marketing Emails in HubSpot. Beginning January 28th, 2026, folderID property will stop working. Use only folderIdV2 property in your API requests after this date. Full details are available in this changelog.

Why it matters

To focus our future development efforts on the improved V3 Marketing Email API, which offers a richer and more comprehensive experience, we're sunsetting the folderId object for the Email API.

Produced by Value-First Media