Skip to content
Book a demo

Connect documentation

All documentation
Documentation

Hubspot: Most-used fields

The table below gives information about most-used fields that you can import from Hubspot. Other fields might also be available in Adverity.

The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.

FieldAdverity UI nameType
abDimension

Identifies a characteristic related to A/B testing, which allows for testing two variations of content (e.g., emails, landing pages) to determine performance.

abVariationDimension

Indicates if the email is an A/B test variation.

absoluteUrlDimension

The absolute URL of the published content.

account_creation_dateDimension

The date when a HubSpot account was created.

address_countryDimension

The country component of an address.

ageDimension

The age of a contact.

allEmailCampaignIdsDimension

A list of unique identifiers for all email marketing campaigns associated with a specific email or event.

amountMetric

The monetary value associated with a deal.

analyticsPageIdMetric

The unique identifier for the analytics page associated with the content.

analyticsPageTypeDimension

The type of analytics page associated with the content.

appNameDimension

The name of the application or integration that is connecting to and interacting with the HubSpot API.

archivedDimension

A boolean indicating whether an object or record has been archived.

archivedAtMetric

The timestamp when the record was archived.

associatedcompanyidMetric

This field historically represented the ID of the primary company associated with a contact. It is now a read-only property, with associations managed through HubSpot's CRM Associations API.

associations.1-17Dimension

Represents a specific type of association between two CRM records (e.g., a contact and a company), identified by its numerical `associationTypeId`. These IDs define the nature of the relationship, which can be either HubSpot-defined or custom.

associations.ids.1-17Metric

A list of unique identifiers (IDs) of records that are associated with another record through a specific relationship type, where `1-17` represents the numerical `associationTypeId` defining that relationship.

authorDimension

The author of the content.

authorNameDimension

The display name of the author.

birth_dateDimension

The birth date of a contact.

blogEmailTypeDimension

The type of blog email, such as instant, daily, or weekly digest.

blogRssSettingsDimension

Settings related to RSS feed for blog subscriptions.

businessUnitIdMetric

The unique identifier of the business unit (brand) associated with a marketing asset or record.

calculated_revenueMetric

The revenue value for a company or deal, which is automatically calculated by HubSpot based on associated deals closed as won or other defined calculation properties.

campaignDimension

The name or ID of a marketing campaign.

campaign nameDimension

The name of an email marketing campaign.

campaignNameDimension

The name of a marketing campaign.

campaignUtmDimension

The UTM campaign parameter value associated with an event or record.

campaign_nameDimension

The name of the marketing campaign an email or other content belongs to.

categoryIdMetric

The unique identifier for the category of the content.

channelDimension

The marketing channel through which an interaction occurred (e.g., email, social media, organic search).

channel_drill_down_{NUM}Dimension

Provides detailed breakdown of the marketing channel that led to an interaction, with '{NUM}' indicating the level of drill-down detail (e.g., 'channel_drill_down_1' for primary channel, 'channel_drill_down_2' for secondary).

cityDimension

The city component of an address.

clonedFromMetric

The ID of the original object from which this record was cloned.

closed_lost_reasonDimension

The reason why a deal was marked as 'closed lost' in the sales pipeline.

closed_won_reasonDimension

The reason or explanation provided when a deal is marked as 'closed won' in the sales pipeline. This field helps track and analyze successful deal outcomes.

closedateclosedatetimeDimension

The date and time when a deal was closed.

cms_content_idDimension

A unique identifier for a content object within the HubSpot CMS, used for tracking changes and auditing content history.

companies.cityDimension

The city where the associated company is located.

companies.closedateMetric

The date the company became a customer, automatically set when the company is moved to the 'Customer' lifecycle stage.

companies.countryDimension

The country where the associated company is located.

companies.domainDimension

The primary website domain of the company.

companies.hs_analytics_sourceDimension

The original traffic source of a company's interaction or origin, used for analytics and reporting on how the company was first engaged.

companies.hs_analytics_source_data_{NUM}Dimension

Additional granular details about the company's analytics source, providing more specific context on the engagement (e.g., specific campaign, content).

companies.hs_lead_statusDimension

The lifecycle stage of a company, indicating its current status within the sales or marketing funnel (e.g., lead, marketing qualified lead, customer). This is often an internal property name for 'Lifecycle stage'.

companies.hs_redirect_domainDimension

A property associated with a company record in HubSpot CRM, indicating a domain used for redirection for that company.

companies.hubspot_owner_idDimension

The unique identifier of the HubSpot user assigned as the owner of a company record.

companies.hubspot_team_idDimension

The unique identifier for the HubSpot team assigned to a company record, used for organizational and reporting purposes.

companies.industryDimension

The primary industry in which the company operates.

companies.lifecyclestageDimension

The stage in the company's journey with your business (e.g., subscriber, lead, MQL, SQL, customer). This value is automatically populated by HubSpot.

companies.nameDimension

The name of the associated company.

companies.ownernameDimension

The name of the HubSpot user assigned as the owner of the company record.

companies.recent_deal_close_dateMetric

The close date of the most recent deal associated with the company.

companyDimension

This field refers to the Company object in HubSpot, which stores data about businesses and organizations that interact with your business.

company.cityDimension

The city where the company is located.

company.closedateDimension

The date the company became a customer, automatically set when the company is moved to the 'Customer' lifecycle stage.

company.countryDimension

The country where the company is located.

company.country_tierMetric

The geographic tier or category assigned to the company's country.

company.createdateMetric

The date and time when the company record was created.

company.domainDimension

The primary website domain name associated with the company. This field is a key unique identifier used to avoid duplicate company records.

company.first_conversion_dateDimension

The date when the first associated contact with the company submitted a form or completed a conversion action, automatically set by HubSpot.

company.first_deal_created_dateDimension

The date when the first deal associated with the company was created in HubSpot.

company.hs_analytics_latest_sourceDimension

The original source of the company's last interaction (e.g., Organic Search, Paid Social).

company.hs_analytics_latest_source_data_{NUM}Dimension

The latest source data recorded by HubSpot analytics for a company, indexed by a number.

company.hs_analytics_sourceDimension

The original source of the company's first interaction with your business.

company.hs_analytics_source_data_{NUM}Dimension

Historical or aggregated source data recorded by HubSpot analytics for a company, indexed by a number.

company.hs_country_codeDimension

The two-letter country code (e.g., US) for the company's location.

company.hs_createdateDimension

The date and time when the company record was created in HubSpot.

company.hs_date_entered_leadDimension

The date when the company entered the 'Lead' lifecycle stage.

company.hs_lastmodifieddateDimension

The most recent date when any property on the company record was updated. This value is automatically set by HubSpot.

company.hs_lead_statusDimension

The lead status of the company, indicating its position in the sales funnel.

company.hs_object_idMetric

The unique identification number assigned by HubSpot to each company record. This is a primary identifier for the object.

company.industryDimension

The primary industry in which the company operates.

company.lifecyclestageDimension

The current lifecycle stage of the company (e.g., Prospect, Customer).

company.linkedin_company_pageDimension

The URL of the company's LinkedIn profile page.

company.nameDimension

The name of the company.

company.num_associated_dealsMetric

The total number of deals currently associated with this company. This value is automatically updated by HubSpot.

company.stateDimension

The state or region in the company's address.

company_idDimension

The unique identifier for a company record.

contactListIds.enrolledDimension

A list of unique identifiers for the contact lists or marketing automation workflows that a contact is currently enrolled in.

contact_countryDimension

The country where the contact is located.

contact_creation_sourceDimension

The specific source (e.g., 'Form Submission', 'Manual Entry') through which the contact record was created.

contact_idDimension

The unique identifier for a contact record.

contact_job_titleDimension

The professional job title of the contact.

contact_organisationDimension

The name of the company or organization that the contact is associated with.

contact_sectorDimension

The industry or sector in which the contact's organization operates. While "industry" is a standard property in HubSpot, "sector" typically refers to the same concept.

contact_sourceDimension

The original source or method by which the contact record was created in HubSpot (e.g., organic search, referral, direct traffic).

contact_typeDimension

The lifecycle stage of a contact, indicating their journey through the sales and marketing funnel (e.g., subscriber, lead, customer).

contentDimension

The main textual or HTML content of an object, such as a marketing email or a note.

content.widgets.hs_email_body.body.htmlDimension

The HTML content of the email body, specifically within a HubSpot email widget.

contentTypeCategoryMetric

The category or type of the content, such as 'BLOG_POST', 'EMAIL', or 'LANDING_PAGE'.

countryDimension

The country associated with a contact or company record.

create_dateDimension

The date and time when a record (e.g., deal, contact, company) was initially created. This property can be set or updated by users, or automatically populated by HubSpot if not explicitly provided.

createdDimension

The timestamp indicating when a record or object was created.

createdAtDimension

The timestamp when the record was created.

createdByAgentDimension

Indicates whether an object, such as an engagement, was created by an agent or a system process.

createdByIdMetric

The ID of the user who created the record.

createdatecreatedatetimeDimension

This field stores the date and time when a record (e.g., deal, contact, company) was initially created in HubSpot. It is automatically set by HubSpot, but can sometimes be set or updated via API.

creationSource.createdAtDimension

The timestamp, in ISO 8601 format, indicating when the record or object was created at its origin or within HubSpot. It represents the creation date of the source event.

creation_dateDimension

The date when the record (contact, company, deal) was created in HubSpot.

crmObjectIdMetric

A generic unique identifier for any HubSpot CRM object (e.g., contact, company, deal).

currentStateDimension

The current state of the content or object.

currentlyPublishedDimension

Indicates if the content is currently published.

customReplyToDimension

The custom 'reply-to' email address set for an email campaign or send.

customReplyToEnabledDimension

A boolean indicating if a custom 'reply-to' email address is enabled for an email.

dateMetric

The date of an event or record creation.

date_of_submissionDimension

The date and time when a form was submitted.

datetimeDimension

The full date and time of an event.

days_to_closeMetric

The number of days it took to close a deal from its creation date to the 'closed won' or 'closed lost' stage.

dealIdDimension

The unique identifier for a deal record.

deal_sourceDimension

The original source through which a deal was created or originated.

deal_to_amount_{NUM}Metric

The 'to' amount in a deal property history, representing the value of a deal at a specific point in time. The {NUM} indicates a possible index for different deal stages or historical values.

deal_tot_amount_{NUM}Metric

The total amount of a deal, reflecting its value at a certain stage or historical point. The {NUM} indicates a possible index for different deal stages or historical values.

dealnameDimension

The name of the deal.

dealstageDimension

The current stage of the deal in the sales pipeline.

dealtypeDimension

The classification or type of a deal (e.g., New Business, Existing Business).

descriptionDimension

A descriptive text field for an object, such as a line item in a deal, a task, or a note.

domainDimension

The domain associated with the content or email.

emailDimension

The email address associated with a contact or record.

email campaign idMetric

The unique identifier for an email marketing campaign.

emailBodyDimension

The HTML body content of the email.

emailCampaignGroupIdMetric

The unique identifier for the email campaign group to which an email belongs.

emailTemplateModeDimension

The mode or type of an email template used for a marketing email.

emailbodyPlaintextDimension

The plain text body content of the email.

engagements_last_meeting_bookedDimension

The date and time of the last meeting booked with a contact or company, as recorded in HubSpot engagements.

event typeDimension

The classification of an event (e.g., email open, form submission, page view, or a custom event).

event_dateDimension

The date and time when a specific event (e.g., email open, form submission) occurred.

feedbackSurveyIdDimension

The unique identifier for a feedback survey.

fieldTypeDimension

The specific input control type used for a property in HubSpot, such as text, number, date picker, or a dropdown select.

first_conversion_dateDimension

The date and time of the contact's first recorded conversion event.

first_conversion_event_nameDimension

The name of the contact's first recorded conversion event.

first_deal_created_dateMetric

The date when the first deal was created for a contact or company.

first_nameDimension

The first name of the contact.

firstnameDimension

The first name of a person associated with a record.

folderIdMetric

The unique identifier for a folder where assets or files are organized.

folderIdV2Metric

The unique identifier for a folder used to organize content, such as marketing emails, in the current version of the API.

form.campaignGuidDimension

The unique identifier (GUID) of the campaign associated with a form submission.

form.createdAtDimension

The timestamp when the form was created.

form.formTypeDimension

The type of the form, such as 'hubspot' for standard forms, 'captured' for non-HubSpot forms, or 'flow' for pop-up forms.

form.guidDimension

The unique identifier (GUID) for the form.

form.nameDimension

The name of the form.

form.portalIdMetric

The unique identifier for the HubSpot portal where the form resides.

form_nameDimension

The name of the HubSpot form that was submitted.

from.customReplyToDimension

The custom email address specified to receive replies for an email.

from.fromNameDimension

The sender's display name for an email.

from.replyToDimension

The email address designated for replies to the sender.

fromNameDimension

The display name of the sender for marketing emails.

full_nameDimension

The complete name of a contact, often a combined field of first and last name properties.

ga_gclidDimension

The Google Click Identifier (GCLID), a parameter used in Google Ads tracking to pass information about a click from an ad to a website. HubSpot automatically captures this value and associates it with contact records as the `hs_google_click_id` property.

genderDimension

The gender of the contact.

geographic_regionDimension

The broader geographic area or region where the contact resides, which may correspond to a state, province, or other defined territory.

groupNameDimension

The internal name of the property group to which a property belongs.

hs_analytics_average_page_viewsMetric

The average number of website page views recorded for a contact.

hs_analytics_first_referrerDimension

This field records the URL of the first website or source that referred a visitor to your site, capturing the initial point of contact for a lead.

hs_analytics_first_timestampDimension

The earliest recorded timestamp for any website activity or interaction by a contact.

hs_analytics_first_touch_converting_campaignDimension

The HubSpot campaign identifier that represents the very first marketing interaction a contact had before converting.

hs_analytics_first_urlDimension

This field records the URL of the very first page a contact visited on your website, automatically set by HubSpot. It is a read-only property.

hs_analytics_first_visit_timestampDimension

The timestamp of the contact's first recorded visit to the website.

hs_analytics_last_referrerDimension

The URL of the last referring website that brought the contact to your site.

hs_analytics_last_timestampDimension

The most recent recorded timestamp for any website activity or interaction by a contact.

hs_analytics_last_touch_converting_campaignDimension

The HubSpot campaign identifier that represents the last marketing interaction a contact had before converting.

hs_analytics_last_urlDimension

The URL of the last page visited by the contact on your website.

hs_analytics_last_visit_timestampDimension

The timestamp of the contact's most recent visit to the website.

hs_analytics_num_page_viewsDimension

The total number of website page views recorded for a contact.

hs_analytics_num_visitsDimension

The total number of visits recorded for a contact on the website.

hs_analytics_sourceDimension

The original source through which a contact or company was acquired (e.g., Organic Search, Social Media, Referral). This is a HubSpot internal analytics property.

hs_analytics_source_data_{NUM}Dimension

Detailed data about the source through which a contact or company was acquired, with '{NUM}' representing a specific data point or index. This is a HubSpot internal analytics property.

hs_calculated_phone_numberMetric

A phone number calculated or derived by HubSpot for a contact.

hs_campaignDimension

The identifier of a HubSpot marketing campaign to which an email, landing page, or other asset belongs.

hs_closed_amountMetric

The monetary amount of a closed deal.

hs_closed_amount_in_home_currencyMetric

The monetary value of a closed deal, expressed in the HubSpot account's primary currency.

hs_created_by_user_idDimension

The unique identifier of the HubSpot user who created the record.

hs_createdateDimension

The date and time when the HubSpot object was created.

hs_date_entered_appointmentscheduledDimension

The date and time when a deal entered the 'Appointment Scheduled' stage in the sales pipeline.

hs_date_entered_closedlostDimension

The date and time when a deal entered the 'Closed Lost' stage in the sales pipeline.

hs_date_entered_closedwonDimension

The date and time when a deal entered the 'Closed Won' stage in the sales pipeline.

hs_date_entered_contractsentDimension

The date and time when a deal entered the 'Contract Sent' stage in the sales pipeline.

hs_date_entered_decisionmakerboughtinDimension

The date and time when a deal entered the 'Decision Maker Bought-in' stage in the sales pipeline.

hs_date_entered_presentationscheduledDimension

The date and time when a deal entered the 'Presentation Scheduled' stage in the sales pipeline.

hs_date_entered_qualifiedtobuyDimension

The date and time when a deal entered the 'Qualified to Buy' stage in the sales pipeline.

hs_date_exited_appointmentscheduledDimension

The date and time when a deal exited the 'Appointment Scheduled' stage in the sales pipeline.

hs_date_exited_closedlostDimension

The date and time when a deal exited the 'Closed Lost' stage in the sales pipeline.

hs_date_exited_closedwonDimension

The date and time when a deal exited the 'Closed Won' stage in the sales pipeline.

hs_date_exited_contractsentDimension

The date and time when a deal exited the 'Contract Sent' stage in the sales pipeline.

hs_date_exited_decisionmakerboughtinDimension

The date and time when a deal exited the 'Decision Maker Bought-in' stage in the sales pipeline.

hs_date_exited_presentationscheduledDimension

The date and time when a deal exited the 'Presentation Scheduled' stage in the sales pipeline.

hs_date_exited_qualifiedtobuyDimension

The date and time when a deal exited the 'Qualified to Buy' stage in the sales pipeline.

hs_deal_amount_calculation_preferenceDimension

A setting that defines how the amount of a deal is calculated in HubSpot.

hs_deal_scoreDimension

The predictive score calculated by HubSpot's AI to assess the health and likelihood of a deal closing successfully.

hs_deal_stage_probabilityMetric

The probability percentage associated with the current stage of a deal.

hs_email_bounceMetric

An indicator of whether an email sent to a contact has bounced, or the type of bounce (e.g., hard bounce, soft bounce), reflecting email deliverability issues for a recipient.

hs_email_clickDimension

A boolean indicating whether a contact has clicked on a link within an email.

hs_email_deliveredDimension

A boolean indicating whether a marketing email was successfully delivered to the contact.

hs_email_first_click_dateDimension

The date and time when a contact first clicked on a link in a marketing email.

hs_email_first_open_dateDimension

The date and time when a contact first opened a marketing email.

hs_email_first_send_dateDimension

The date and time when the first marketing email was sent to a contact.

hs_email_last_click_dateDimension

The date and time when a contact last clicked on a link in a marketing email.

hs_email_last_email_nameDimension

The name of the last marketing email sent to the contact.

hs_email_last_open_dateDimension

The date and time when a contact last opened a marketing email.

hs_email_last_send_dateDimension

The date and time when the last marketing email was sent to a contact.

hs_email_openDimension

A boolean indicating whether a contact has opened a marketing email.

hs_email_quarantinedDimension

A boolean indicating whether a contact's email address has been quarantined due to deliverability issues.

hs_email_sends_since_last_engagementMetric

The number of marketing emails sent to a contact since their last engagement (e.g., open or click).

hs_google_click_idDimension

The Google Click Identifier (GCLID) associated with a contact or company from Google Ads clicks.

hs_is_closedDimension

A boolean indicating whether a deal has been closed, either as 'won' or 'lost'.

hs_is_closed_lostDimension

A boolean indicating if a deal has been closed and lost.

hs_is_closed_wonDimension

A boolean indicating if a deal has been closed and won.

hs_journey_stageDimension

The current stage of a contact in their customer journey.

hs_lastmodifieddateDimension

The date and time when the HubSpot object was last modified.

hs_latest_meeting_activityDimension

The date or details of the most recent meeting engagement associated with a record.

hs_latest_sourceDimension

This field indicates the most recent source or channel through which a contact or company interacted with your content or website.

hs_latest_source_data_{NUM}Dimension

This field provides additional granular details or a drill-down level about the latest source of interaction, offering more context beyond the primary `hs_latest_source` field.

hs_lead_statusDimension

The current lead status of a contact.

hs_lifecyclestage_customer_dateDimension

The date and time when a contact or company transitioned into the 'Customer' lifecycle stage.

hs_likelihood_to_closeDimension

A score or percentage representing the predicted likelihood of a deal being closed successfully.

hs_manual_campaign_idsDimension

A list of manually assigned HubSpot campaign IDs associated with an object.

hs_manual_forecast_categoryDimension

A category assigned for sales forecasting, often set manually (e.g., 'Commit', 'Best Case', 'Pipeline').

hs_marketable_statusDimension

The marketing status of a contact, indicating whether they are eligible to receive marketing emails.

hs_merged_object_idsDimension

A list of unique identifiers for records that have been merged into the current record.

hs_next_step_updated_atDimension

The timestamp when the 'next step' property of a CRM object (e.g., deal, contact) was last updated by HubSpot.

hs_object_idDimension

The unique identifier for a HubSpot CRM object (e.g., contact, company, deal, engagement).

hs_object_sourceDimension

The source from which the HubSpot CRM object (e.g., contact, company, deal) was created or last updated.

hs_object_source_detail_{NUM}Dimension

Additional details about how a contact or company record was created in HubSpot, where {NUM} indicates the detail level.

hs_object_source_labelDimension

A descriptive, human-readable label indicating the origin or creation source of the HubSpot object (e.g., 'Offline Source', 'Organic Search').

hs_open_deal_create_dateDimension

The creation date of the earliest open deal associated with a contact or company.

hs_pipelineDimension

The sales pipeline that a deal belongs to, which defines the stages of the sales process for that deal.

hs_predicted_amountDimension

The predicted monetary value of a deal.

hs_predicted_amount_in_home_currencyDimension

The predicted monetary value of a deal, expressed in the HubSpot account's primary currency.

hs_projected_amountDimension

The projected monetary value of a deal.

hs_projected_amount_in_home_currencyDimension

The projected monetary value of a deal, expressed in the HubSpot account's primary currency.

hs_sales_email_last_repliedDimension

The date and time of the most recent reply to a sales email associated with a contact or deal.

hs_time_between_contact_creation_and_deal_closeMetric

The duration between the creation date of a contact and the close date of their first associated deal.

hs_time_between_contact_creation_and_deal_creationMetric

The duration (in milliseconds) between the creation of a contact record and the creation of their first associated deal.

hs_time_in_closedlostDimension

The duration (in milliseconds) a deal spent in the 'Closed Lost' stage.

hs_time_in_closedwonMetric

The duration (in milliseconds) a deal spent in the 'Closed Won' stage.

hs_time_in_contractsentDimension

The duration (in milliseconds) a deal spent in the 'Contract Sent' stage.

hs_updated_by_user_idDimension

The unique identifier of the user who last updated the record.

hs_v2_date_entered_current_stageDimension

The date a contact or company entered their current lifecycle stage.

hs_v2_date_entered_customerDimension

The date a contact or company entered the 'Customer' lifecycle stage.

hs_v2_date_entered_evangelistDimension

The date a contact or company entered the 'Evangelist' lifecycle stage.

hs_v2_date_entered_leadDimension

The date a contact or company entered the 'Lead' lifecycle stage.

hs_v2_date_entered_marketingqualifiedleadDimension

The date a contact or company entered the 'Marketing Qualified Lead' lifecycle stage.

hs_v2_date_entered_opportunityDimension

The date a contact or company entered the 'Opportunity' lifecycle stage.

hs_v2_date_entered_otherDimension

The date a contact or company entered an 'Other' lifecycle stage.

hs_v2_date_entered_salesqualifiedleadDimension

The date a contact or company entered the 'Sales Qualified Lead' lifecycle stage.

hs_v2_date_entered_subscriberDimension

The date a contact or company entered the 'Subscriber' lifecycle stage.

hs_v2_date_entered_{NUM}Dimension

The date an object entered a specific stage or state, corresponding to an older HubSpot v2 property, indexed by a number.

hs_v2_date_exited_marketingqualifiedleadDimension

The date a contact or company exited the 'Marketing Qualified Lead' lifecycle stage.

htmlTitleDimension

The HTML title of the content.

hubspot_ownerDimension

The name of the HubSpot user assigned as the owner of a record.

hubspot_owner_assigneddateDimension

The date and time when a HubSpot owner was most recently assigned to a CRM record (e.g., contact, company, deal).

hubspot_owner_idDimension

The unique identifier of the HubSpot user assigned as the owner of a record.

hubspot_team_idDimension

The unique identifier of the HubSpot team associated with a record.

hubspotscoreMetric

The lead score assigned to a contact within HubSpot, indicating their engagement and likelihood to become a customer based on predefined criteria.

idDimension

The unique identifier for the record.

industryDimension

The industry sector in which a company operates.

ip_cityDimension

The city derived from the IP address associated with a contact's interaction.

ip_countryDimension

The country derived from the IP address associated with a contact's interaction.

ip_state_codeDimension

The state or region code derived from the IP address associated with a contact's interaction.

isAbDimension

A boolean indicating whether a marketing email or content is part of an A/B test.

isGraymailSuppressionEnabledDimension

A boolean indicating if graymail suppression is enabled for email campaigns to avoid sending to less engaged recipients.

isPublishedDimension

Indicates whether the content (e.g., an email) has been published.

isRecipientFatigueSuppressionEnabledDimension

A boolean indicating if recipient fatigue suppression is enabled to prevent over-mailing contacts.

isTransactionalDimension

Indicates if an email is a transactional email (e.g., order confirmation) rather than a marketing email.

job_functionDimension

The primary job function or area of responsibility for a contact.

jobtitleDimension

The job title of a contact.

labelDimension

The user-friendly name or display label for a property or item.

languageDimension

The language preference of a contact or the language of a content asset.

lastmodifieddateDimension

The date and time when the record was last modified.

lastnameDimension

The last name of a person associated with a record.

latest_source_drill_down_{NUM}Dimension

Provides granular details about the most recent traffic source through which a contact interacted with the business. These properties (e.g., Drill-Down 1, Drill-Down 2) offer increasing levels of specificity, such as the specific social media platform or the name of a marketing campaign.

leadidDimension

A unique identifier for a lead.

leadstatusDimension

The current status of a lead in the sales or marketing process.

lifecyclestageDimension

The current lifecycle stage of a contact or company (e.g., Subscriber, Lead, Customer).

list.archivedDimension

A boolean indicating if the list is archived.

list.authorIdMetric

The unique identifier of the user who created the list.

list.createdAtDimension

The date and time when the list was created.

list.createdByIdMetric

The unique identifier of the user who created the contact list.

list.deletedDimension

A boolean indicating if the list has been deleted.

list.dynamicDimension

A boolean indicating if the list is a dynamic (active) list that updates automatically.

list.filtersUpdatedAtDimension

The date and time when the filters defining the contact list were last updated.

list.internalDimension

A boolean indicating if the list is an internal HubSpot list.

list.internalListIdMetric

The internal unique identifier for the list.

list.limitExemptDimension

Indicates if a specific list is exempt from certain API rate limits or restrictions.

list.listIdMetric

The unique identifier for the list.

list.listPermissionsDimension

The permissions configured for accessing or modifying the contact list.

list.listTypeDimension

The type of list, such as 'STATIC' or 'ACTIVE'.

list.listVersionMetric

The version identifier for the contact list.

list.membershipSettingsDimension

Settings related to how contacts are added or removed from the list.

list.nameDimension

The name of the list.

list.objectTypeIdDimension

The object type associated with the list (e.g., '0-1' for contacts).

list.portalIdMetric

The HubSpot portal ID where the list resides.

list.processingStatusDimension

The current processing status of the contact list (e.g., 'ACTIVE', 'PROCESSING').

list.processingTypeDimension

The type of processing applied to the list, such as 'STATIC' or 'ACTIVE' (dynamic).

list.readOnlyDimension

A boolean indicating if the list is read-only.

list.sizeMetric

The total number of contacts currently in the list.

list.teamIdsDimension

A list of team IDs that have access to or are associated with a particular list.

list.updatedAtDimension

The date and time when the list was last updated.

list.updatedByIdMetric

The unique identifier of the HubSpot user who last updated the list.

liveDomainDimension

The live domain where the content is published.

lost_reasonDimension

The reason why a deal was marked as lost.

mailingListsExcludedDimension

A property or record indicating the email marketing lists from which a contact is specifically excluded.

mailingListsIncludedDimension

A property or record indicating the email marketing lists in which a contact is currently included.

marketing_emails_clicked_on_openedMetric

The total number of marketing emails that a contact has clicked on or opened.

maxRssEntriesMetric

The maximum number of RSS entries to display in an email.

mobilephoneDimension

The mobile phone number of a contact.

nameDimension

The name of the record or content (e.g., email name, form name).

nationalityDimension

The nationality of a contact.

newsletter_subscriptionDimension

Indicates the contact's subscription status for newsletters, often managed through a boolean property or a multi-checkbox property for various subscription types.

notes_last_contactedDimension

The date and time of the last contact interaction, often derived from notes or other engagements.

notes_last_updatedDimension

The date and time when notes associated with a record were last updated.

notes_next_activity_dateDimension

The date of the next scheduled activity related to a record, often derived from notes or tasks.

num_associated_contactsMetric

The total number of contacts currently associated with a particular CRM object, such as a company or a deal.

num_associated_dealsMetric

The number of deals currently associated with a contact or company. For deals, a property named 'Number of associated contacts' exists.

num_notesDimension

The total number of notes associated with a record.

number_of_deals_in_{NUM}Metric

The number of deals in a specific stage or category. The {NUM} indicates a possible index for different deal stages.

opt_in_privacy_marketing_time_stampDimension

The timestamp when a contact explicitly opted in to receive privacy-related marketing communications.

opt_out_newsletter_time_stampDimension

The timestamp when a contact unsubscribed or opted out from newsletter communications.

opt_out_privacy_marketing_time_stampDimension

The timestamp when a contact explicitly opted out from privacy-related marketing communications.

originDimension

The source or origin from which a record or interaction was created.

ownernameDimension

The name of the HubSpot user assigned as the owner of the record (contact, company, or deal).

page.idMetric

The unique identifier for a specific page in HubSpot's CMS.

page.nameDimension

The name or title of a specific page in HubSpot's CMS.

pageExpiryDateMetric

The date and time when a HubSpot content page is scheduled to expire.

pageExpiryEnabledDimension

Indicates whether an expiry date is enabled for a specific content page in HubSpot.

pageExpiryRedirectUrlDimension

The URL to which visitors are redirected after a HubSpot content page expires.

pageRedirectedDimension

Indicates if a page or web version is configured to redirect to another URL.

phoneDimension

The primary phone number associated with a contact or record.

pipelineDimension

The sales pipeline to which a deal belongs.

pipeline_statusDimension

The current stage of a deal within its sales pipeline, indicating its progress.

portalIdDimension

The unique identifier for the HubSpot portal (account).

postal_addressDimension

The postal address of a contact or company.

previewKeyDimension

A key used to access a preview of content, such as an email or page.

primaryEmailCampaignIdMetric

The unique identifier of the primary email campaign associated with an object or event.

processingStatusDimension

The current processing status of the content or task.

publishDateDimension

The date and time when the content (e.g., email, page) was published.

publish_dateDimension

The date when content (e.g., blog post, page, email) was published.

publishedAtDimension

The timestamp when the content was published.

publishedByEmailDimension

The email address of the user who published a piece of content.

publishedByIdMetric

The user ID of the person who published a piece of content.

publishedByNameDimension

The name of the user who published a piece of content.

recent_deal_amountMetric

The amount of the most recently closed deal associated with a contact or company.

recent_deal_close_dateDimension

The date when the most recent deal associated with a contact or company was closed.

recipientDimension

The email address of the recipient for an email event or communication.

requiredDimension

A boolean indicator specifying whether a particular field or property is mandatory when creating or updating a record in HubSpot.

rssEmailAuthorLineTemplateDimension

A template used to define the format of the author's line in an RSS-to-email feed.

rssEmailBlogImageMaxWidthMetric

The maximum width allowed for blog images within an RSS-to-email campaign.

rssEmailByTextDimension

The text used to denote the author in an RSS-driven email.

rssEmailClickThroughTextDimension

The click-through text used in an RSS-driven email.

rssEmailCommentTextDimension

The comment text used in an RSS-driven email.

rssEmailEntryTemplateDimension

A template used to define the structure and content of an individual entry within an RSS-to-email feed.

rssEmailEntryTemplateEnabledDimension

Indicates if an RSS email entry template is enabled.

rssEmailImageMaxWidthMetric

The maximum width for images in an RSS-driven email.

rssEmailUrlDimension

The URL of the RSS feed used for an RSS-driven email.

rssToEmailTimingDimension

The scheduling or frequency settings for sending out RSS-to-email updates.

rssUrlDimension

The URL of the RSS feed used for pulling content into RSS-to-email campaigns.

sales_emails_openedMetric

The total number of sales emails sent to a contact that have been opened.

sales_emails_replied_toMetric

The total number of sales emails sent to a contact that have received a reply.

securityStateDimension

The security status or state of a piece of content or an object.

sendOnPublishDimension

A boolean indicating if the content (e.g., email, social post) should be sent or published immediately upon creation.

sentBy.createdDimension

The timestamp indicating when an engagement or activity, such as an email, was created or logged by a sender in HubSpot. This often maps to the `hs_timestamp` property for engagements.

sentBy.idDimension

The unique identifier (ID) of the HubSpot owner (user or team) responsible for creating or sending the associated engagement or activity, such as an email. This often maps to the `hubspot_owner_id` property.

slugDimension

The URL slug for the content.

sourceDimension

The general source from which a record or activity originated.

source_drill_down_{NUM}Dimension

Provides granular details about the original (first known) traffic source through which a contact interacted with the business. These properties (e.g., Drill-Down 1, Drill-Down 2) offer increasing levels of specificity, such as the specific social media platform, search term, or the name of a marketing campaign.

start_dateDimension

The date and time when an event, campaign, or activity began.

stateDimension

The current state or status of the content (e.g., DRAFT, PUBLISHED).

stats.counters.bounceMetric

The count of emails that bounced during a campaign send.

stats.counters.clickMetric

The total number of clicks on links within the email.

stats.counters.contactslostMetric

The number of contacts lost (e.g., unsubscribed or hard bounced).

stats.counters.deliveredMetric

The total number of emails successfully delivered to recipients.

stats.counters.droppedMetric

The number of emails that were not sent by HubSpot due to various reasons (e.g., invalid email, unengaged).

stats.counters.hardbouncedMetric

The number of emails that resulted in a permanent delivery failure.

stats.counters.notsentMetric

The number of emails that were not sent for various reasons.

stats.counters.openMetric

The total number of times the email was opened by recipients.

stats.counters.pendingMetric

The number of emails that are currently awaiting delivery.

stats.counters.replyMetric

The total number of replies received for the email.

stats.counters.selectedMetric

The number of contacts selected as recipients for the email.

stats.counters.sentMetric

The total number of emails sent.

stats.counters.softbouncedMetric

The number of emails that resulted in a temporary delivery failure.

stats.counters.spamreportMetric

The number of times the email was marked as spam by recipients.

stats.counters.suppressedMetric

The number of emails that were suppressed (not sent) due to various reasons (e.g., unsubscribed, bounced).

stats.counters.unsubscribedMetric

The number of recipients who unsubscribed from the email list.

stats.deviceBreakdown.click_device_type.computerMetric

The number of clicks from computer devices.

stats.deviceBreakdown.click_device_type.mobileMetric

The number of clicks from mobile devices.

stats.deviceBreakdown.click_device_type.unknownMetric

The number of clicks from unknown device types.

stats.deviceBreakdown.open_device_type.computerMetric

The number of opens from computer devices.

stats.deviceBreakdown.open_device_type.mobileMetric

The number of opens from mobile devices.

stats.deviceBreakdown.open_device_type.unknownMetric

The number of opens from unknown device types.

stats.ratios.bounceratioMetric

The percentage of sent emails that resulted in a bounce (delivery failure).

stats.ratios.clickratioMetric

The percentage of delivered emails that received at least one click.

stats.ratios.clickthroughratioMetric

The percentage of delivered emails that resulted in a click on a link.

stats.ratios.contactslostratioMetric

The ratio of contacts who were lost (e.g., unsubscribed, hard bounced) from an email campaign.

stats.ratios.deliveredratioMetric

The percentage of sent emails that were successfully delivered to recipients.

stats.ratios.hardbounceratioMetric

The percentage of sent emails that resulted in a hard bounce (permanent delivery failure).

stats.ratios.notsentratioMetric

The percentage of emails that were scheduled to be sent but were not actually sent.

stats.ratios.openratioMetric

The percentage of delivered emails that were opened by recipients.

stats.ratios.pendingratioMetric

The percentage of emails for which the delivery status is still pending.

stats.ratios.replyratioMetric

The percentage of delivered emails that received a reply from recipients.

stats.ratios.softbounceratioMetric

The percentage of sent emails that resulted in a soft bounce (temporary delivery failure).

stats.ratios.spamreportratioMetric

The percentage of delivered emails that were marked as spam by recipients.

stats.ratios.unsubscribedratioMetric

The percentage of delivered emails that resulted in a recipient unsubscribing.

stats_failedToLoadDimension

Indicates if statistics or an asset failed to load, commonly seen in email marketing performance data.

stats_ratios_bounceratioMetric

The ratio of total bounced emails to the total emails sent.

stats_ratios_clickratioMetric

The ratio of unique clicks on marketing emails to unique email opens.

stats_ratios_clickthroughratioMetric

The click-through rate, representing the ratio of unique clicks to total emails delivered.

stats_ratios_contactslostratioMetric

The ratio of contacts lost (e.g., unsubscribed, bounced) from an email list.

stats_ratios_deliveredratioMetric

The ratio of successfully delivered marketing emails to the total emails sent.

stats_ratios_hardbounceratioMetric

The ratio of hard bounced emails to the total emails sent, indicating permanent delivery failures.

stats_ratios_notsentratioMetric

The ratio of emails that were not sent to the intended recipients.

stats_ratios_openratioMetric

The ratio of unique marketing email opens to the total emails delivered.

stats_ratios_pendingratioMetric

The ratio of emails that are currently in a pending state before sending.

stats_ratios_replyratioMetric

The ratio of replies received for marketing emails relative to the number of emails delivered.

stats_ratios_softbounceratioMetric

The ratio of soft bounced emails to the total emails sent, indicating temporary delivery failures.

stats_ratios_spamreportratioMetric

The ratio of spam reports to the total emails delivered.

stats_ratios_unsubscribedratioMetric

The ratio of contacts who unsubscribed from marketing emails to the total emails delivered.

statusDimension

The current status of an object, such as a deal, workflow, or export.

subcategoryDimension

A more specific classification under a main category for an object or content.

subjectDimension

The subject line of the email or communication.

submission_sourceDimension

The method or tool by which a record was originally created or submitted into HubSpot (e.g., Form, Import, CRM UI, Integration, API).

submission_typeDimension

The classification of the form that received the submission, such as a HubSpot-created form, a captured external HTML form, a pop-up form (flow), or a blog comment form.

subscriptionBlogIdMetric

The unique identifier of the blog to which a subscription is associated.

subscriptionDetails.officeLocationIdMetric

The unique identifier for the office location associated with a subscription.

subscriptionDetails.subscriptionIdMetric

The unique identifier for a subscription.

subscriptionNameDimension

The name of the email subscription type.

templatePathDimension

The file path to the email or content template used.

testing.abSampleSizeDefaultDimension

The default sample size percentage used for A/B testing variations.

testing.abSamplingDefaultDimension

The default sampling method for A/B testing.

testing.abStatusDimension

The current status of an A/B test.

testing.abSuccessMetricDimension

The metric used to determine the winner of an A/B test (e.g., open rate, click-through rate).

testing.abTestPercentageMetric

The percentage of recipients included in the A/B test.

testing.hoursToWaitMetric

The number of hours to wait before automatically choosing an A/B test winner.

testing.testIdMetric

The unique identifier for an A/B test.

toDimension

The primary recipient's email address or name for an email communication.

total_amountMetric

The monetary value of a deal.

total_revenueMetric

The total revenue generated from all associated deals for a company or a contact.

transactionalDimension

Indicates if an email is a transactional email, used for non-marketing communications such as order confirmations.

typeDimension

The type of an object or property (e.g., string, number, email for properties; EMAIL, CALL for engagements).

unpublishedAtMetric

The timestamp when content, such as an email or page, was unpublished.

unsubscribe_dateDimension

The date a contact unsubscribed from all email communications or a specific subscription type.

unsubscribe_statusDimension

Indicates a contact's subscription status for marketing emails, showing whether they are opted in or opted out of specific subscription types or all email communications.

updatedAtDimension

The timestamp when the record was last updated.

updatedByIdMetric

The ID of the user who last updated the record.

urlDimension

The URL associated with the record or content.

useRssHeadlineAsSubjectDimension

A boolean indicating whether the RSS feed headline should be used as the email subject line for blog subscription emails.

utm_campaignDimension

The UTM campaign parameter used to track the performance of a marketing campaign.

utm_contentDimension

The UTM tracking parameter for ad content, used to differentiate between ads within the same campaign.

utm_mediumDimension

The UTM medium parameter used to track the channel of a marketing campaign (e.g., email, social).

utm_sourceDimension

The UTM source parameter used to track the origin of a marketing campaign (e.g., google, facebook).

utm_termDimension

The UTM tracking parameter for paid search keywords, identifying the keyword that led to a contact.

validation.dataDimension

The specific data value that failed a validation rule when submitting or updating information via the API.

validation.messageDimension

A human-readable message providing details about why a validation error occurred for a specific field or data submission.

validation.nameDimension

The internal name of the field or property that triggered a validation error.

version_dateDimension

This field refers to the date of the HubSpot API version used for data collection, following a YYYY-MM format, indicating the release date of the API specification.

version_timestampDimension

A timestamp indicating the version or last modification time of an object.

webversion.domainDimension

The domain used for the web version of an email or landing page.

webversion.enabledDimension

A boolean indicating whether a public web version of an email is enabled.

webversion.isPageRedirectedDimension

A boolean indicating if the web version of an email redirects to a different URL.

webversion.metaDescriptionDimension

The meta description for the web version of the content.

webversion.slugDimension

The URL slug or identifier for the web version of an email.

webversion.urlDimension

The URL for the web version of the content.