# Marketing Email API v1 sunset on 2025-11-01

- **Provider:** HubSpot
- **Endpoint:** `* /marketing-emails/v1/**`
- **Effective:** 2025-11-01
- **Severity:** critical
- **Change:** version-sunset
- **Status:** verified

## What changed

HubSpot sunset the v1 Marketing Email API (/marketing-emails/v1/...) on 2025-11-01 in favour of the Marketing Email v3 API; requests to v1 after that date return an error. Other legacy email APIs, including email analytics, are not affected. HubSpot's changelog post is now a 404, so the source is its Wayback Machine copy.

## What to do

Move email calls from /marketing-emails/v1/emails to the Marketing Email v3 API (POST /marketing/v3/emails to create, GET /marketing/v3/emails to list, GET /marketing/v3/emails/{emailId} to read one) and read folders from folderIdV2: folderId was removed from v3 on 2026-01-28. Other legacy email APIs, such as email analytics, are not part of this sunset.

## Sources

- Provider notice (2025-04-02): https://web.archive.org/web/20251114203334/https://developers.hubspot.com/changelog/marketing-email-api-v3-released-to-general-availability-and-upcoming-sunset-for-v1
- https://developers.hubspot.com/changelog/marketing-email-api-folder-id-migration
- https://developers.hubspot.com/docs/api-reference/marketing-marketing-emails-v3/guide

## Machine-readable

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