View Data From Your Custom Built Application Inside HubSpot
Using HubSpot custom cards, you are able to view outside data from other systems inside of HubSpot on associated records. You can see in the image below what customized cards would look like pulling in bugs reported from an app or website.

Current State
Business Problem
- Employees are spending lots of time looking in two separate computer systems to find the information they need
- There are many internal information requests across teams or roles
Business Impact
- Low overall employee effectiveness
- Low ability to respond quickly, and accurately to opportunities
Technical Cause
- Teams have specialized systems with specific features that are critical to each team
- There is an intentional barrier between systems due to data structures, or processing requirements
Future State
Your users should have the experience of,
- HubSpot users can see information from another system inside HubSpot
- HubSpot users can trigger a series of simple actions between systems (optional)
Card Layout

Architecture Patterns
The following diagrams show examples of system architecture to view outside data in custom cards in HubSpot. We can provide deeper technical discussions, and ideation sessions with your team by request.
Connecting Via API

Connecting Via Direct Connection

Data Mapping
You will need to determine a key that exists in both systems. Examples might be
Contacts
- HubSpot Contact ID
- Other system Contact ID
- email address
Companies
- HubSpot Company ID
- Other system Company ID
- Domain name
- EIN
When configuring the custom cards, you create a schema for the cards. HubSpot will use this schema to determine what properties it sends in the http endpoint of your middleware application.

Error Handling
| Error | Actions |
| Middleware / Micro service Outage |
HubSpot records continue to load. Error message displayed on cards. |
| Data format issue between systems |
HubSpot records continue to load. Error message displayed on cards. |
| No data available to be shown in cards |
HubSpot records continue to load. No cards are loaded |