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://developers.hubspot.com/changelog/marketing-email-api-folder-id-migration
- https://developers.hubspot.com/docs/api-reference/marketing-marketing-emails-v3/guide
Check your code
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