How to interact with "upcoming events"

[GBakonyi]

Hi,

I am facing an interesting issue. On the contacts view, on the right side panel, there are cards named "upcoming events" and "contact analytics".

However, I do not find any explicit SDK or API documentation on interacting with those cards.

HS contact screenshot

I marked with red on the screenshots what cards I mean.

Does anyone have any idea or reference point on how I can add information for those cards via the SDK or HTTP API calls?

I had no luck interacting with the chatbot or finding any useful article, video, or segment of the documentation that was useful.

Any ideas or thoughts are welcome.

[kosalaindrasiri]

Hey @GBakonyi,
These are custom CRM cards added via the CRM Development Tools or private apps, often under the CRM extensions API. ( CRM Cards Documentations )

If you're seeing those cards and can't trace their source:

• Go to Settings → Integrations → Connected Apps

• Look for an app or internal developer project providing CRM Cards

These cards are not editable from the HubSpot UI—you must control them via the CRM Card API setup.

[MichaelMa]

Those cards have a notation at the bottom, where you blacked some of it out, that says "Powered by" which means they're not Hubspot cards. Find what app installed them and look up what they do.

The Test cards are probaby Private App or Project so you should be able to ask whoever installed them how they are accessing the data.

The other app, with the green logo, is Demio. Their marketplace app shows what they mostly use in terms of objects. Looks like they use Contacts, Lists and Timeline for storing their info.

https://app.hubspot.com/ecosystem/4926072/marketplace/apps/demio-418995

[GBakonyi]

Thank you. 

If it is a private app, and the event is powered by 3rd party, still, the question is, which SDK or API endpoint (or dataset) should be used to populate them? 

I did not find any use case, video, or article, how those panels/cards can be used or populated with data.

[MichaelMa]

I'm not sure I understand the question.

The cards use React (TSX or JSX) and likely NodeJS to render the card. If they are interacting your with Hubspot data, then they are using the Hubspot API endpoints to access the data. What SDK library would be up to whatever language they built the card in which is likely NodeJS so the NodeJS library (https://github.com/HubSpot/hubspot-api-nodejs). What data they use is up to what the app is designed for.

Demio looks to be for tracking events from their platform in Hubspot and their marketplace page shows what objects they are interacting with.

The private/test app is custom so whoever built that can tell you what API endpoints and objects they are using.

Someone in your Hubspot account installed the apps. It is not installed by default. You can ask the people who installed what the use-case for the cards are in your hub.

[GBakonyi]

Let me clarify, then. 

I am using the following SDK calls to save/update contacts and add them to an event list: 
 - client.crm.contacts.searchApi.doSearch
 - client.crm.contacts.basicApi.update
 - client.crm.contacts.basicApi.create
 - client.crm.timeline.eventsApi.create
 - client.crm.properties.coreApi.getAll

I did not configure or do anything that should have an `Upcoming event` section or data, or even the keyword.

I expected to have a straightforward API or SDK endpoint that states: okay, send here the event data, and it will show up in the upcoming event card. 

But there is nothing straightforward (hehe, expecting this in the marketing world), no information on how that card was created, why it was created, what it expects, or how I can interact with it.

As I tested the 

api.hubapi.com/marketing/v3/marketing-events/events

endpoint, which has nothing to do with this "upcoming event" card data.

Now I have a wild guess, might be that card can be populated via a timeline event call? (Unfortunately, the documentation is quite bad; the Postman collection is most of the time just simply not working, even with official examples.)

[MichaelMa]

The Test cards (along with Demio cards) are custom cards. We have no way to know how it's built short of you providing the source code. They are not Hubspot native cards.

If you're basing your code on an example or someone else's code, you should be able to find how the card operates by viewing their code for the card. If you didn't install these cards, then you need to find who installed them and get the source code.

[GBakonyi]

---

@MichaelMa wrote:

The Test cards (along with Demio cards) are custom cards. We have no way to know how it's built short of you providing the source code. They are not Hubspot native cards.

---

The part that is weird is why those cards are built automatically. Along the lines, one of the requests subsequently creates them.

Is there any way to list the custom cards properly? The SDK and HTTP API requests refuse to work due to an error:

AppId~XXXX must own the eventTypes being used: YYYYYYY

The request was: 

await hubspotClient.crm.extensions.cards.cardsApi.getAll(appId);

The AppId I just copied from the Dev account (the same one that has the actual application).

Note: the app is public

[GBakonyi]

This is super interesting because I have the source code and literally zero parts that interact with any kind of cards, just the SDK endpoints from above.

Does this mean, theoretically, via the CRM card API endpoints, I should be able to list my existing cards? (As I checked in my app settings, there is literally zero card in the app list)