When HubSpot shows “Email API v1 is deprecated… migrate to v3,” use this article to confirm whether you must act or can safely ignore it.
Use this article when…
- You see the HubSpot banner “Email API v1 is deprecated and set to be removed… Please migrate to v3.”
- You use Avid’s HubSpot integration and want to know if your email sending is at risk.
- Your org also has custom HubSpot apps and you need to know who must migrate them.
Applies to
| Integrations | Avid-managed HubSpot integration; any additional HubSpot Private apps your org owns. |
|---|---|
| Plans | All Avid plans. |
| Roles | Users with access to HubSpot Settings and Integrations. |
| Timeline | HubSpot Email Marketing API v1 deprecation and removal in favor of v3 (effective November 1, 2025). |
Good to know
Avid has migrated our managed HubSpot connections and models to the Email Marketing v3 API ahead of the v1 shutdown. For Avid-managed integrations, your data pipeline and sending should continue to work during and after the cutover.
Quick checks
- Confirm if you use only Avid’s managed integration.
If your team connects HubSpot to Avid only through the standard Avid integration that Avid set up, you can ignore the banner. No action is required. - Check whether you own any custom or “Private app” integrations.
If your engineering team, agency, or vendor built a custom HubSpot integration, that app may still call the Email API v1. That app must be upgraded to v3. - If you are unsure, review HubSpot’s connected apps.
Use the steps below to see which apps are connected to your HubSpot portal.
Decide if you need to act
- You use only Avid’s managed HubSpot integration
→ Do nothing. Avid maintains the migration to the Email Marketing v3 API. - You also have custom code or a “Private app” in HubSpot
→ That app’s owner must migrate all Email API calls from v1 to v3. Avid cannot update your private code. - You are unsure which apps you use
→ Follow the “Check connected apps in HubSpot” section, then share this article with the owner of any non-Avid app.
Check connected apps in HubSpot
- In HubSpot, click the Settings (gear) icon.
- In the left sidebar, go to Integrations → Connected apps.
- Review the list:
- Look for Avid’s standard HubSpot integration that your Avid team set up.
- Look for any Private apps or custom connections owned by your org or vendor.
- If you see only the standard Avid connection and no private apps:
- No action is needed. You can ignore the banner.
- If you see one or more private or custom apps:
- Identify the owner (internal developer, IT team, or external vendor).
- Send them this article and ask them to migrate their HubSpot Email API usage to v3.
If you manage a custom or private app
If your team owns a HubSpot Private app or custom integration that sends or manages marketing emails, you must update it.
- Audit your HubSpot integration code for any Email Marketing v1 endpoints.
- Update all Email API calls from v1 endpoints to their Email Marketing v3 equivalents.
- Deploy the updated code to your staging or test environment.
- Send test emails to a non-production or internal list.
- Monitor logs for HTTP
4xxand5xxresponses from HubSpot. - After successful tests, deploy to production and repeat a small test send.
- Remove any remaining references to v1 endpoints from your codebase.
Important
After HubSpot fully turns off the Email Marketing v1 API, any custom app still calling v1 will receive errors and may fail to send or update emails. Avid-managed integrations will continue using v3, but your private apps will not.
After you complete the checks above, you know whether the HubSpot banner requires action. If your org uses only the Avid-managed integration, you can ignore the banner. If you own custom apps, you have routed the v3 migration work to the right technical owner.
FAQ
Why am I seeing the banner if Avid is already on v3?
HubSpot may still show a global deprecation notice even when your Avid-managed integration already uses v3. The banner does not always identify which connection triggered it.
We also built our own integration. Who updates that?
Your internal developer, IT team, or vendor must update their code to use HubSpot’s Email Marketing v3 API. Avid does not have access to your private app code.
Can Avid migrate our private app for us?
Avid Support can advise on expected behavior and where to look in HubSpot logs. We cannot directly edit or deploy your private integration code.
Notes / limits
- The banner text may read: “Email API v1 is deprecated and set to be removed… Please migrate to v3 as soon as possible.”
- HubSpot does not always show which specific app triggered the deprecation banner. That is why connected app screenshots and details are important.
- When you share screenshots with Avid Support, avoid embedding critical instructions only in images. Add short alt text or a caption that summarizes what the screenshot shows for accessibility.