Objects and Associations
HubSpot for Jira works with four HubSpot object types. Each one can be associated with a Jira work item, and each has a default property used to identify it.
Supported object types
Object type | Default unique property | Typical use |
|---|---|---|
Contact | The person who raised or is affected by the work item | |
Company | Company Name | The organisation the work relates to |
Deal | Deal Name | Revenue or opportunity affected by the work |
Ticket | Ticket Name | A HubSpot support ticket tracked alongside Jira |
The unique property matters when you build automation rules. A rule that looks up an existing object matches on it, so your field mapping must target the property you intend. Mapping to the wrong one means the lookup will not find the object and the rule creates a duplicate instead.
The properties above are defaults, not the only options. Any HubSpot property marked Require unique values for this property in HubSpot is also offered in the rule’s HubSpot unique field list. HubSpot allows up to ten unique properties per object type.
Associations
An association is the link between a HubSpot record and a Jira work item. Associations are:
Many to many. A work item can link to several HubSpot records, and one HubSpot record can link to several work items.
Visible from both sides. The linked records appear in the HubSpot CRM panel on the work item, and the linked work items appear on the HubSpot record.
Non-destructive. Removing an association unlinks the two records. Neither the work item nor the HubSpot record is deleted.
The app does not update existing HubSpot records. It reads them, and it can create new ones, either manually or through an automation rule. Changes made in Jira are never written onto a HubSpot record that already exists.
Writing into Jira works differently: Jira work items can be both created and updated from HubSpot.
Where associations are created
From a Jira work item, using the HubSpot CRM panel
From a HubSpot record, using the Jira card
Automatically, using an automation rule in either direction
Reporting on associations
The app also writes the number of linked records of each type into four Jira custom fields, named HubSpot Contacts, HubSpot Companies, HubSpot Deals and HubSpot Tickets. These hold counts for search and reporting only. They are not how records are linked, and they populate only after Synchronize Data has run.