Association label module

Developer Support CMS Development
1

Hi :waving_hand:!

anyone… need help in creating a module for quote template. The module should simply fetch all deal associated contact with their labels.

ex. Fullname, association label

Thanks!!!

2

Hi @ZoMi

HubSpot doesn’t offer a built-in “Association Label” module that you can directly add to quote templates

You can create a custom code that utilizes the HubSpot Workflows API to fetch the necessary data

Create a workflow that triggers on “Deal: New” or another relevant event.

Within the workflow, add a custom code snippet action.

This code will use the Workflows API to:

  • Access the current deal properties.
  • Use the associations endpoint of the HubSpot CRM API to retrieve all associated contacts for the deal.
  • Loop through each associated contact and use the getAssociationLabel method (available in the Workflows API) to fetch the corresponding label for that contact.
  • Combine the contact’s full name with the retrieved label and store this information in a custom deal property (e.g., “Associated Contacts with Labels”).

Make use of the knowledge base for more help

Create and use association labels (hubspot.com)

Hope this helps - Happy to help further!!
Thank you very much and have a great one!
Warm regards

3

Thanks Humasshankar,
I allresdy have a flow that populates properties baesd on contact association label, but I wanted directly to loop trough deal associated contacts and based on their association label add them to specific places in my quote. So this is not posible with labels… :-(. Maybe it’s easier to fetch the data from workflow properties, but this I’ll need to research on how to.

Option1:

I found the following in some threads and I was wondering if it could be used?, and if yes then if it could be modefied to fetch my defined "TypId"s “labels”?

{% set quote_associated_object = crm_associations(template_data.quote.associated_objects.deal.hs_object_id, "USER_DEFINED", "association type ID", "limit=200", "property field that you need to fetch from the custom object - internal name", false) %}

Option2:
Is it posibel to pre-define the quote code with my labels and based on “TypeId” or “label” achive what I want?

Using this endpoint : https://api.hubapi.com/crm/v4/associations/0-3/0-1/labels

I get this responce:
{

*"results": \[*

    *{*

        *"category": "HUBSPOT\_DEFINED",*

        *"typeId": 3,*

        *"label": null*

    *},*

    *{*

        *"category": "USER\_DEFINED",*

        *"typeId": 3,*

        *"label": "Borgensperson 2"*

    *},*

    *{*

        *"category": "USER\_DEFINED",*

        *"typeId": 15,*

        *"label": "Firmatecknare 4"*

    *},*

    *{*

        *"category": "USER\_DEFINED",*

        *"typeId": 5,*

        *"label": "Borgensperson 3"*

    *},*

    *{*

        *"category": "USER\_DEFINED",*

        *"typeId": 9,*

        *"label": "Firmatecknare 1"*

    *},*

    *{*

        *"category": "USER\_DEFINED",*

        *"typeId": 17,*

        *"label": "Kredittagare"*

    *},*

    *{*

        *"category": "USER\_DEFINED",*

        *"typeId": 11,*

        *"label": "Firmatecknare 2"*

    *},*

    *{*

        *"category": "USER\_DEFINED",*

        *"typeId": 7,*

        *"label": "Borgensperson 4"*

    *},*

    *{*

        *"category": "USER\_DEFINED",*

        *"typeId": 1,*

        *"label": "Borgensperson 1"*

    *},*

    *{*

        *"category": "USER\_DEFINED",*

        *"typeId": 13,*

        *"label": "Firmatecknare 3"*

    *}*

*]*

}

4

Hi @ZoMi

Thanks for adding more background on your standing - that helps!!

To your point

Yes, it is possible to pre-define your quote code to create a dynamic quote template which incorporates associated contacts based on your pre-defined labels

  • Make your quote code with placeholders where you want to insert the contact information based on labels.
  • Try using tokens or specific markers to identify these placeholders (Instance- {{Borgensperson_1}}, {{Firmatecknare_2}}).

Make use of Hubspot’s templating language or your quote editor’s functionality to dynamically populate the placeholders with contact information

  • Use the associations/0-3/0-1/labels endpoint, as you have mentioned to retrieve all your association labels.
  • Loop through the retrieved labels array.
  • For each label, use conditional statements to check the label or typeId
  • Based on the matching label or typeId, identify the corresponding contact information using the HubSpot CRM API
  • consider using the GET /crm/v4/objects/contacts endpoint to fetch contacts based on association with the deal
  • Once you have the contact information, populate the corresponding placeholder in your quote code with the retrieved data for name, email, and more.

Help guide on Quote - Create and share quotes (hubspot.com)

Hope this helps - Happy to help further!!
Thank you very much and have a great one!
Warm regards

5

Hi Hamashakar,
I managed to put together a workflow code snippet to fetch all deal associated contacts and their association label. Here is an example… the resoult.
Social_security_number + Firstname + Lastname + ContactType(thel abel)

ZoMi_0-1715790700028.png
ZoMi_0-1715790700028.png1111Ă—183 39.1 KB

What remains is now to create a dynamical quote template module.js and addapt it to use as you sugested some identefiers for placing the information in the quote. In my case this identifyers is the association label (ContactType).

6

Hi again,

I’m new at this and not a developer, but I have the will to learn, and to do so, I need some help and guidance.

As described before, I would like to get the associated contacts’ (firstname, lastname) and their association label (in my case, e.g., “Guarantor_1,” “Guarantor_2,” “Guarantor_3”).

This is how far I’ve progressed, but I’m not getting what I need.

Please, someone provide a simple example of how to achieve this. I’m confident that if I just get an example for at least one, then I’ll manage myself.

Here is my code:

const hubspot = require(“@hubspot/api-client”);

const dealId = “Register-ID”; // This is the deal Record-ID

exports.main = async (event, callback) => {

const hubspotClient = new hubspot.Client({ apiKey: process.env.TOKEN });

try {

// Fetch associated contacts for the deal

const apiResponse = await hubspotClient.apiRequest({

method: “GET”,

path: `/crm/v4/objects/deals/${dealId}/associations/contacts`,

headers: {

accept: “application/json”,

“content-type”: “application/json”,

},

});

// Process the contacts data from apiResponse

const associatedContacts = apiResponse.body.results;

const contactNames = associatedContacts.map(contact => `${contact.properties.firstname} ${contact.properties.lastname}`);

// Callback with specific values (dealname and associated contact names)

callback({

outputFields: {

associatedContacts: contactNames.join(", "), // Concatenate contact names

},

});

} catch (err) {

console.log(“ERROR:”, err);

}

};