HubSpot is making a modification to their API that is a breaking change for all TIBCO Scribe® Online Connections that use the HubSpot Connector. Here is what you need to know.
What is the modification that HubSpot is making?
- HubSpot is shutting down their OAuth1 system, removing support for authentication using OAuth 1.0 when connecting to their API.
When is HubSpot dropping this support?
- HubSpot will be shutting down this system on August 11, 2017. Existing Connections that use OAuth1 should continue to work until December 31, 2017.
IMPORTANT NOTE: Best practice is to follow the instructions below to update your HubSpot Connections as soon as the update to the HubSpot Connector is released.
What is TIBCO Scribe® doing to help users transition from OAuth 1.0 to OAuth 2.0?
- TIBCO Scribe® is providing a release of the HubSpot Connector that allows our users to re-authenticate their existing HubSpot Connections using OAuth 2.0. Any new HubSpot Connections automatically use OAuth 2.0 authentication. The tentative release date is July 14, 2017.
- Earlier releases of the TIBCO Scribe® Online Connector for HubSpot supported only OAuth 1.0 authentication.
- As of the July 24, 2017 release of the TIBCO Scribe® Online Connector for HubSpot both OAuth 1.0 and OAuth 2.0 authentication are supported to facilitate this transition.
What do I need to do to make sure my integrations run without interruption?
- Any and all HubSpot Connections created prior to the July 24, 2017 release must be re-authenticated to update the Connection to use OAuth 2.0 authentication.
To re-authenticate, open the Connection dialog in TIBCO Scribe® Online for each HubSpot Connection and click the Authenticate button. Authenticating resets the authentication for the Connection to OAuth 2.0. Click OK to test and save the Connection.
- Maps accessing the EmailEvent and/or the EmailCampaign entity using a HubSpot Connection with user credentials for a HubSpot user with CRM-only access may encounter errors once the Connection is upgraded from OAuth 1.0 to OAuth 2.0. CRM-only users no longer have access to these entities with OAuth 2.0 authentication.
To make sure these Maps continue to run either re-connect as a Marketing user or ask your HubSpot Marketing administrator to add Marketing access to the CRM-only user configured in the Connection dialog.
If you need further assistance with changes to HubSpot user permissions, contact your HubSpot representative.
NOTE: Best practice is to complete this process prior to the August 11, 2017 shutdown date. Your integrations should continue to connect to HubSpot until December 31, 2017. However, in the event that there is an issue with continued OAuth 1 support, your integrations could stop connecting to HubSpot unexpectedly.
If you have any questions or concerns regarding this change, contact Support.
For additional information, refer to the HubSpot information on this topic:
[HubSpot Developers] - Migrate your integration to OAuth 2.0
Shutting Down OAuth 1