Ecommerce Bridge - Where to start?


#1

Is there a more general guide to the Ecommerce Bridge? The current documentation is difficult to penetrate and there is no step-by-step guide on what one should do in order to set this up. Where should we start? What do we need to do first?

Any help appreciated.


#3

Hi @j_j,

The developer documentation and the API Explorer are the best resources at this time, but I am happy to pass this feedback along and clarify any points of confusion.

To begin, are you building a custom integration with one portal or implementing an ecommerce bridge application?

If you are building a custom integration, you would start by installing the ecommerce bridge into a portal using this endpoint. You would then set up mappings from properties in your domain to HubSpot properties via this endpoint.

If you are implementing an ecommerce bridge application, you would jump straight to setting up mappings for properties with this endpoint and then proceed through the import process.


#4

Hi Isaac,

Appreciate the reply. We have one ecommerce website that we want to "attach" to Hubspot to assist with CRM and measure sales etc. i don't really know what API we need since the Hubspot documentation does not really tell us. If we want to convert our orders to deals, our customers to contacts and tell Hubspot about our products, what do we need? Terminology is also a problem. Is a "portal" our public website for example? What is a "custom integration" and how does that differ from an "ecommerce bridge" or can they be the same thing?


#5

Hi @j_j,

Happy to clarify.

By "portal," I mean your organization's instance of the HubSpot software.

Your information will sync into HubSpot via the Ecommerce Bridge in one way or another. It could be via a "custom integration" which you and a developer would build for only your organization, or you could build an "ecommerce bridge application" that uses the same APIs but is authenticated and installed differently, or you could use an ecommerce bridge application that someone else has built and HubSpot has verified is safe for public use.

Does your website use a third-party ecommerce app like Shopify, WooCommerce, or Magento, or is it a completely custom setup?

The answer to the above will help inform which route I advise.


#6

We have a bespoke ecommerce website and want to integrate HS with that.


#7

Hi @j_j,

If that's the case, then either a custom integration which uses a single API key or a private OAuth 2.0 "ecommerce bridge application" would be suitable. That said, if we're just talking about your one site, the custom integration is the easier route.

As mentioned above, you'll start by installing the ecommerce bridge into a portal using this endpoint . You will then set up mappings from properties in your domain to HubSpot properties via this endpoint .

Once this is done, you can start sending sync messages from your site's backend into HubSpot to create, update, and delete contacts, deals, products, and line items.