# Please update your entity relationship diagram

**URL:** <https://community.hubspot.com/t/please-update-your-entity-relationship-diagram/34517>\
**Category:** CMS Development\
**Created:** [March 25, 2021, 11:51am UTC](https://community.hubspot.com/t/please-update-your-entity-relationship-diagram/34517 "2021-03-25T11:51:13Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![cmadison](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/cmadison/32/21752_2.png) [@cmadison](https://community.hubspot.com/u/cmadison)\
**Post date:** [March 25, 2021, 11:51am UTC](https://community.hubspot.com/t/please-update-your-entity-relationship-diagram/34517/1 "2021-03-25T11:51:13Z")

</div>

Hello,

The entity relationship diagram (ERD) on the Understanding the CRM page is out of date and contains wrong information. For example, it shows a 1:M relationship between companies & deals when it should be a M:M relationship. Additionally, newer object types like Quotes are missing. This is diagram is a valuable tool for developers and should not be neglected.

> **[Understanding the CRM APIs - HubSpot docs](https://developers.hubspot.com/docs/api-reference/latest/crm/understanding-the-crm)**
>
> HubSpot’s CRM is a system for managing customer relationships and data. Learn about objects and the related CRM APIs.

Thanks,

Chris

---

<div class="post-metadata">

**Author:** ![dennisedson](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/dennisedson/32/28044_2.png) [@dennisedson](https://community.hubspot.com/u/dennisedson)\
**Post date:** [March 25, 2021, 7:27pm UTC](https://community.hubspot.com/t/please-update-your-entity-relationship-diagram/34517/2 "2021-03-25T19:27:23Z")

</div>

@cmadison , thanks!

Brought to the attention of the team 😀

---

<div class="post-metadata">

**Author:** ![AGibson](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/agibson/32/78471_2.png) [@AGibson](https://community.hubspot.com/u/AGibson)\
**Post date:** [June 18, 2021, 6:39am UTC](https://community.hubspot.com/t/please-update-your-entity-relationship-diagram/34517/3 "2021-06-18T06:39:13Z")

</div>

Just adding my vote on needing this.  
Connecting ‘Contacts’ with ‘Contact Lists’ is not clear…

---

<div class="post-metadata">

**Author:** ![illestMaestro](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/illestmaestro/32/29572_2.png) [@illestMaestro](https://community.hubspot.com/u/illestMaestro)\
**Post date:** [May 6, 2022, 10:37pm UTC](https://community.hubspot.com/t/please-update-your-entity-relationship-diagram/34517/4 "2022-05-06T22:37:26Z")

</div>

Any status update on this? We’re diagramming our custom objects, and our team’s non-techy people are confused. Would love to build our ERD off of HubSpot’s & simply include our own custom objects/association labels.

---

<div class="post-metadata">

**Author:** ![dennisedson](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/dennisedson/32/28044_2.png) [@dennisedson](https://community.hubspot.com/u/dennisedson)\
**Post date:** [May 9, 2022, 1:41pm UTC](https://community.hubspot.com/t/please-update-your-entity-relationship-diagram/34517/5 "2022-05-09T13:41:28Z")

</div>

@illestMaestro ,

It appears that [the ERD](https://lucid.app/documents/embeddedchart/ea90eecf-e825-4476-b918-d8f6ddb53a81#) was updated in March of 2022

---

<div class="post-metadata">

**Author:** ![shields-mops](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/shields-mops/32/56310_2.png) [@shields-mops](https://community.hubspot.com/u/shields-mops)\
**Post date:** [February 28, 2024, 4:30am UTC](https://community.hubspot.com/t/please-update-your-entity-relationship-diagram/34517/6 "2024-02-28T04:30:17Z")

</div>

@cmadison , have you found a current HubSpot CRM entity relationship diagram? I could not find a complete and current HubSpot ERD, 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-1724%2C3274%2C1752%2C0\_0&invitationId=inv\_4328c2ec-314f-4387-b8fd-aebe0b8898cb](https://lucid.app/lucidchart/6a45d47c-99f2-40f0-a353-dec7dc151d95/edit?viewport_loc=76%2C-1724%2C3274%2C1752%2C0_0&invitationId=inv_4328c2ec-314f-4387-b8fd-aebe0b8898cb).