APIs & Integrations

tkravchuk
Member

Relationship Diagram

Hello,

 

I'm a new developer to Hubspot. I'm trying to wrap my head around the data relationships among all the different API objects. To make this more straightforward, it would be great to take a look at an ERD, or entity relationship diagram, in order to more easily work with Hubspot data.

 

I haven't been able to find one in the docs or past posts herein.

Could someone point me in the right direction to find one?

6 Replies 6
bbuchert
Participant

Relationship Diagram

https://fivetran.com/docs/applications/hubspot Maybe the erds listed here help.

shields-mops
Participant

Relationship Diagram

@tkravchuk  I could not find a complete HubSpot ER Diagram, so I made the Best HubSpot ER Diagram yet in Lucidchart at https://lucid.app/lucidchart/6a45d47c-99f2-40f0-a353-dec7dc151d95/edit?viewport_loc=76%2C-1558%2C327...

I need the engagement entities to be more organized on the map. If you have those engagement relationships solved, let's work together to improve the map.

gogeeprime
Member

Relationship Diagram

Just FYI, it looks like now HubSpot's API supports marketing email (as well as a lot more) — https://legacydocs.hubspot.com/docs/methods/lists/marketing-email-overview

0 Upvotes
Willson
HubSpot Employee
HubSpot Employee

Relationship Diagram

Hey @tkravchuk 

 

You can find the HubSpot ERD on this documentation here.

 

I hope this helps!

Product Manager @ HubSpot
0 Upvotes
DrAJ71
Participant

Relationship Diagram

Hi @Willson ,

 

The ERD says it was updated in March 2022, however it still glosses over emails - Emails are still summarised within an 'Engagement' entity with 'Type(oneof: Email, Call, Task, Meeting, Note)'.

 

I'm using an API to enable visualisations of HubSpot data in Tableau (for all it's benefits, I find HubSpot enforces too much 'silo-ing' of data for full analysis of results across different entities), and from looking at tables via Tableau Prep, there appear to be a number of email/campaign related tables underlying HubSpot - 'Campaign', 'CampaignEmail', and 'CampaignEmailEvent'.

 

It would simplify things enormously if we could see just how these are related to each other, as well as to 'Contact' and 'Company' entities. I'm sure i'll figure it out, but it would be useful to easily see what the relevant primary and foreign keys are for each relationship.

 

Sincerely,

 

Andy

tkravchuk
Member

Relationship Diagram

Hi @Willson,

 

It looks like this revolves around the CRM system, and marketing emails aren't included.

Looking for how lists relate to marketing emails and contacts, and any other relationships on the marketing email delivery side of your system. Is there an ERD for those?

 

Thanks