HubSpot Connector Objects (hubspot Schema)

NameDescription
AnalyticsBreakdownsGet analytics data broken down by the specified category.
AnalyticsContentsGet analytics data for your HubSpot hosted content. This would include your website and landing pages, as well as any blog pages hosted on HubSpot.
AnalyticsEventCompletionsGet analytics data for event completion objects.
AnalyticsFormsGet analytics data for form objects.
AnalyticsSessionsGet analytics data broken down by sessions.
AnalyticsSocialAssistsGet analytics data for social assist objects.
AnalyticsViewsGet the details for the analytics views set up in the portal.
BlogAuthorsRetrieve the available blog authors in HubSpot.
BlogPostsRetrieve the available blog posts in HubSpot.
BlogsRetrieve the available blogs in HubSpot.
BlogTopicsRetrieve the available blog topics in HubSpot.
CommentsRetrieve the available comments from your blog in HubSpot.
CompaniesCompanies may be kept track of in HubSpot just like contacts. They can be added to, updated, and removed from this table.
CompanyPropertiesCompany properties are the standard and custom pieces of field data that appear in HubSpot.
CompanyPropertiesHistoryA list of the historical values of the property.
CompanyPropertyGroupsCompany property groups in HubSpot offer a way of organizing individual types of properties for companies. Each company property must belong to a property group.
ContactFormSubmissionsList of Contact's Form Submissions.
ContactIdentityProfilesList of Contact's Identity profiles
ContactListMembershipsReturns the list memberships of contacts in HubSpot.
ContactListsContact lists in HubSpot can be used to group together contacts with similar characteristics.
ContactPropertiesContact properties are the standard and custom pieces of field data that appear in HubSpot.
ContactPropertiesHistoryA list of the historical values of the property.
ContactPropertyGroupsContact property groups in HubSpot offer a way of organizing individual types of properties for contacts. Each contact property must belong to a property group.
ContactsYour contacts in HubSpot may be used for marketing campaigns and can be retrieved, inserted, updated, and deleted from this table.
ContactsInListRetrieves the contacts in a given list in HubSpot. New contacts may be added to the list or removed from it. A ListId must be specified to retrieve the current contacts in the list.
ContactStatisticsBasic contact statistics that can be retrieved from HubSpot such as the total number and when the last new contact was created.
CrmAssociationsQuery the available CRM Associations in HubSpot.
DealAssociationsDeal associations can be used to insert or delete individual associations with Deals.
DealPipelinesDeal pipelines may be used to organize what stages a given deal is on.
DealPipelineStagesThe stages for a given Deal Pipeline.
DealPropertiesDeal properties are the standard and custom pieces of field data that appear in HubSpot.
DealPropertiesHistoryA list of the historical values of the property.
DealPropertyGroupsContact property groups in HubSpot offer a way of organizing individual types of properties for contacts. Each contact property must belong to a property group.
DealsYour deals in HubSpot which may be used for making offers to potential customers.
DealStagesThe stages for a given Deal.
DomainsRetrieve the available domains in HubSpot.
EmailCampaignEventsThe events associated with an email campaign or a recipient.
EmailCampaignsEmail campaigns in HubSpot allow you to keep track of email marketing campaigns.
EmailSubscriptionsThe subscription types a given email is subscribed to. An email must be specified to return results. Subscriptions may be removed by deleting them.
EmailSubscriptionTypesA list of email subscription types for a HubSpot hub.
EngagementsEngagements represent any of a number of different types of engagements you have in HubSpot.
EngagementScheduledTasksList of tasks scheduled for an engagement.
EngagementsScheduledTasksList of tasks scheduled for an engagement.
EnrollmentsGet workflows a contact is currently enrolled in.
EventsReturns all of the event definitions in a given portal.
FilesRetrieves information about the available files in HubSpot.
FoldersRetrieves information about the available folders in HubSpot.
FormFieldsGet fields of HubSpot Forms.
FormsCreate and manage HubSpot Forms.
FormSubmissionsGet the submissions for the specified form.
LineItemPropertiesGet all of the properties for the line item object type, along with the property definitions.
LineItemsQuery the available line items in HubSpot.
MarketingEmailsCreate and manage HubSpot Marketing Emails.
PagesRetrieve the available pages in HubSpot.
ProductPropertiesGet all of the properties for the product object type, along with the property definitions.
ProductsQuery the available products in HubSpot.
SocialMediaChannelsList available social media channels in HubSpot
SocialMediaMessagesCreate and manage HubSpot social media messages.
TemplatesRetrieve the available templates in HubSpot.
TicketPropertiesGet all of the properties for the ticket object type, along with the property definitions.
TicketPropertyGroupsGet all of the property groups for the specified Ticket object type.
TicketsGet all tickets from a portal.
UrlMappingsRetrieve the available url mappings in HubSpot.
WorkflowsSelect and manage HubSpot workflows.
NameTypeReadOnlyReferencesFilterOnlyDescription
TotalsStringTrueNoData will be the totals rolled up.
SourcesStringTrueNoData broken down by traffic source.
GeolocationStringTrueNoData broken down by geographic location.
UtmCampaignsStringTrueNoData broken down by the standard UTM campaigns parameter.
UtmContentsStringTrueNoData broken down by the standard UTM contents parameter.
UtmMediumsStringTrueNoData broken down by the standard UTM mediums parameter.
UtmSourcesStringTrueNoData broken down by the standard UTM sources parameter.
UtmTermsStringTrueNoData broken down by the standard UTM terms parameterpages.
FirstDrilldownStringFalseNoUsed to drilldown into the data. This parameter is designed to reflect the functionality of the HubSpot sources reports.
SecondDrilldownStringFalseNoUsed to further drill down into the data. Similar to FirstDrilldown, this reflects the functionality of the sources report.
BounceRateDoubleFalseNoThe rate of bounces.
ContactToCustomerRateDoubleFalseNoThe rate of contacts to customers.
ContactsLongFalseNoThe number of generated contacts.
CustomersLongFalseNoThe number of generated customers.
LeadsLongFalseNoThe number of leads.
MarketingQualifiedLeadsLongFalseNoThe number of leads which are more likely to become customers.
NewVisitorSessionRateDoubleFalseNoThe session rate for new visitors.
OpportunitiesLongFalseNoThe number of opportunitites.
PageviewsPerSessionDoubleFalseNoThe ratio of page views over sessions.
RawViewsLongFalseNoThe number of raw views.
SalesQualifiedLeadsLongFalseNoThe number of prospective customers that are considered ready for the sales process.
SessionToContactRateDoubleFalseNoThe ratio of sessions over generated contacts.
SubscribersLongFalseNoThe number of subscribers.
TimePerSessionDoubleFalseNoThe time per session.
VisitorsLongFalseNoThe number of visitors.
VisitsLongFalseNoThe number of visits.
BreakdownDateDateFalseNoThe start date of the time period for which the breakdown data are grouped. This column is applicable only for Granularity types: daily, weekly, monthly, summarize/daily, summarize/weekly and summarize/monthly.
StartDateDateFalseYesThe beginning value of the query range.
EndDateDateFalseYesThe ending value of the query range.
GranularityStringFalseYesThe time period used to group the data. Must be one of: total, daily, weekly, monthly, summarize/daily, summarize/weekly, summarize/monthly.
FilterStringFalseYesFilter the returned data to include only the specified breakdown. This parameter can be included multiple times to filter for multiple breakdowns.
ExcludeStringFalseYesExclude data for the specified breakdown. This parameter can be included multiple times to exclude multiple breakdowns.
FilterIdStringFalseYesThe ID of an Analytics view. If included, the returned data will only include data that matches the view.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
LandingPagesStringTrueNoPull data for landing pages.
StandardPagesStringTrueNoPull data for website pages.
BlogPostsStringTrueNoPull data for individual posts.
ListingPagesStringTrueNoPull data for blog listing pages.
KnowledgeArticlesStringTrueNoPull data for knowledge base articles.
AllPagesStringTrueNoGet data for all URLs with data collected by HubSpot tracking code. The results are broken down by URL.
ContactsLongFalseNoThe total number of new contacts generated.
ContactsPerPageviewDoubleFalseNoThe ratio of contacts to raw views.
CtaViewsLongFalseNoThe number of CallsToAction views.
EntrancesLongFalseNoThe number of entrances.
ExitsLongFalseNoThe number of exits.
ExitsPerPageviewDoubleFalseNoThe ratio of exits over page views.
LeadsLongFalseNoThe number of leads.
PageBounceRateDoubleFalseNoThe rate of page bounces.
PageBouncesLongFalseNoThe number of page bounces.
PageTimeLongFalseNoThe time spent on page.
RawViewsLongFalseNoThe number of raw views.
SubmissionsLongFalseNoThe number of submissions.
SubmissionsPerPageviewDoubleFalseNoThe ratio of submissions over page views.
TimePerPageviewDoubleFalseNoThe ratio of time over page views.
BreakdownDateDateFalseNoThe start date of the time period for which the breakdown data are grouped. This column is applicable only for Granularity types: daily, weekly, monthly, summarize/daily, summarize/weekly and summarize/monthly.
StartDateDateFalseYesThe beginning value of the query range.
EndDateDateFalseYesThe ending value of the query range.
GranularityStringFalseYesThe time period used to group the data. Must be one of: total, daily, weekly, monthly, summarize/daily, summarize/weekly, summarize/monthly.
FilterStringFalseYesFilter the returned data to include only the specified breakdown. This parameter can be included multiple times to filter for multiple breakdowns.
ExcludeStringFalseYesExclude data for the specified breakdown. This parameter can be included multiple times to exclude multiple breakdowns.
FilterIdStringFalseYesThe ID of an Analytics view. If included, the returned data will only include data that matches the view.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
EventCompletionsStringTrueNoAnalytics data for event completions.
CompletionsLongFalseNoThe number of event completions.
BreakdownDateDateFalseNoThe start date of the time period for which the breakdown data are grouped. This column is applicable only for Granularity types: daily, weekly, monthly, summarize/daily, summarize/weekly and summarize/monthly.
StartDateDateFalseYesThe beginning value of the query range.
EndDateDateFalseYesThe ending value of the query range.
GranularityStringFalseYesThe time period used to group the data. Must be one of: total, daily, weekly, monthly, summarize/daily, summarize/weekly, summarize/monthly.
FilterStringFalseYesFilter the returned data to include only the specified breakdown. This parameter can be included multiple times to filter for multiple breakdowns.
ExcludeStringFalseYesExclude data for the specified breakdown. This parameter can be included multiple times to exclude multiple breakdowns.
FilterIdStringFalseYesThe ID of an Analytics view. If included, the returned data will only include data that matches the view.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
FormsStringTrueNoAnalytics data for forms.
CompletionsLongFalseNoThe number of completions.
FormViewsLongFalseNoThe number of times the form has been viewed.
InstallsLongFalseNoThe number of installs.
InteractionsLongFalseNoThe number of interactions.
SubmissionsLongFalseNoThe number of submissions.
VisiblesLongFalseNoThe number of times the form has been visible.
BreakdownDateDateFalseNoThe start date of the time period for which the breakdown data are grouped. This column is applicable only for Granularity types: daily, weekly, monthly, summarize/daily, summarize/weekly and summarize/monthly.
StartDateDateFalseYesThe beginning value of the query range.
EndDateDateFalseYesThe ending value of the query range.
GranularityStringFalseYesThe time period used to group the data. Must be one of: total, daily, weekly, monthly, summarize/daily, summarize/weekly, summarize/monthly.
FilterStringFalseYesFilter the returned data to include only the specified breakdown. This parameter can be included multiple times to filter for multiple breakdowns.
ExcludeStringFalseYesExclude data for the specified breakdown. This parameter can be included multiple times to exclude multiple breakdowns.
FilterIdStringFalseYesThe ID of an Analytics view. If included, the returned data will only include data that matches the view.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
SessionsStringTrueNoAnalytics data for sessions.
DesktopLongFalseNoDesktop sessions.
DirectTrafficLongFalseNoDirect sessions.
EmailMarketingLongFalseNoEmail marketing sessions.
MobileLongFalseNoMobile sessions.
OrganicSearchLongFalseNoOrganic search sessions.
OtherCampaignsLongFalseNoOther campaigns sessions.
OthersLongFalseNoOther sessions.
PaidSearchLongFalseNoPaid search sessions.
PaidSocialLongFalseNoPaid social sessions.
ReferralsLongFalseNoReferrals sessions.
SocialMediaLongFalseNoSocial media sessions.
FirstDrilldownStringFalseNoUsed to drilldown into the data. This parameter is designed to reflect the functionality of the HubSpot sources reports.
SecondDrilldownStringFalseNoUsed to further drill down into the data. Similar to FirstDrilldown, this reflects the functionality of the sources report.
BreakdownDateDateFalseNoThe start date of the time period for which the breakdown data are grouped. This column is applicable only for Granularity types: daily, weekly, monthly, summarize/daily, summarize/weekly and summarize/monthly.
StartDateDateFalseYesThe beginning value of the query range.
EndDateDateFalseYesThe ending value of the query range.
GranularityStringFalseYesThe time period used to group the data. Must be one of: total, daily, weekly, monthly, summarize/daily, summarize/weekly, summarize/monthly.
FilterStringFalseYesFilter the returned data to include only the specified breakdown. This parameter can be included multiple times to filter for multiple breakdowns.
ExcludeStringFalseYesExclude data for the specified breakdown. This parameter can be included multiple times to exclude multiple breakdowns.
FilterIdStringFalseYesThe ID of an Analytics view. If included, the returned data will only include data that matches the view.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
SocialAssistsStringTrueNoAnalytics data for social assists.
RawViewsLongFalseNoThe number of raw views.
BreakdownDateDateFalseNoThe start date of the time period for which the breakdown data are grouped. This column is applicable only for Granularity types: daily, weekly, monthly, summarize/daily, summarize/weekly and summarize/monthly.
StartDateDateFalseYesThe beginning value of the query range.
EndDateDateFalseYesThe ending value of the query range.
GranularityStringFalseYesThe time period used to group the data. Must be one of: total, daily, weekly, monthly, summarize/daily, summarize/weekly, summarize/monthly.
FilterStringFalseYesFilter the returned data to include only the specified breakdown. This parameter can be included multiple times to filter for multiple breakdowns.
ExcludeStringFalseYesExclude data for the specified breakdown. This parameter can be included multiple times to exclude multiple breakdowns.
FilterIdStringFalseYesThe ID of an Analytics view. If included, the returned data will only include data that matches the view.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]LongTrueNoId of the analytic view.
TitleStringTrueNoTitle of the analytic view.
CreatorIdLongTrueNoId of the creator.
CreatedAtDateTrueNoDate of the creation.
UpdaterIdLongTrueNoId of the updater.
UpdatedDateDateTrueNoDate of the update.
DeletedAtDateTrueNoDate of the deletion.
ContainsLegacyReportPropertiesBooleanTrueNoDetermines if the view contains legacy report properties.
ReportPropertyFiltersAggregateStringTrueNoReport property filters of the analytic view.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]LongTrueNoThe id of the author.
FullNameStringTrueNoThe first and last name of the blog author.
CreatedAtDatetimeTrueNoWhen the blog author was first created.
SlugStringTrueNoThe path appended to the blog URL at which the author page will live.
DeletedAtDatetimeTrueNoWhen the author was deleted.
EmailStringTrueNoThe email address of the blog author.
FacebookProfileStringTrueNoThe blog author's Facebook page.
GooglePlusProfileStringTrueNoThe blog author's Google Plus profile.
LinkedInProfileStringTrueNoThe blog author's LinkedIn profile
TwitterProfileStringTrueNoThe blog author's twitter handle.
AvatarUrlStringTrueNoA small photo or image of the blog author.
UserIdLongTrueNoThe HubSpot user id of the blog author.
UsernameStringTrueNoThe HubSpot username of the blog author.
WebsiteStringTrueNoThe blog author's web site.
UpdatedAtDatetimeTrueNoWhen the blog author was last updated.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]LongTrueNoThe id of the blog post.
AuthorUserIdLongTrueNoThe HubSpot user id of the blog author.
AuthorNameStringTrueNoThe HubSpot username of the blog author.
BlogAuthorIdLongTrueBlogAuthors.IdNoThe integer id of the blog author, look up via the blog authors end.
CampaignIdStringTrueEmailCampaigns.IdNoThe guid of the marketing campaign this post is associated with.
ContentGroupIdLongTrueNoThe id of the blog that this post belongs to. Get the id by looking at the blog API.
TopicIdsStringTrueNoThe individual topics the post is associated with.
CreatedAtDatetimeTrueNoWhen the post was first created.
ArchivedAtDatetimeTrueNoWhen the post was deleted.
ArchivedInDashboardBooleanTrueNoIf True, the post will not show up in your dashboard, although the post will still be live.
NameStringTrueNoThe internal name of the blog post.
SlugStringTrueNoThe path of the URL on which the post will live.
UpdatedAtDatetimeTrueNoWhen the post was last updated.
PublishedAtDatetimeTrueNoWhen the post was published.
PostSummaryStringTrueNoThe summary of the blog post that will appear on the main listing page.
PostBodyStringTrueNoThe HTML of the main post body.
UrlStringTrueNoThe full URL with domain and scheme to the blog post. Will return a 404 if the post is not yet published.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]LongTrueNoThe id of the blog.
NameStringTrueNoThe internal name of the blog.
AllowCommentsBooleanTrueNoAre comments enabled for the blog.
CommentShouldCreateContactBooleanTrueNoBoolean indicating if an email address that is not listed in your HubSpot contacts creates a comment, should this user be automatically added to your HubSpot contacts.
CreatedAtDatetimeTrueNoWhen the post was first created.
HTMLTitleStringTrueNoThe title in the title attribute of the page, shows up in the browsers title bar and as the title in Google search results.
LanguageStringTrueNoThe language of the blog.
PostsPerListingPageLongTrueNoThe number of posts listed per page in the HTML viewable blog.
PostsPerRSSFeedLongTrueNoThe number of posts listed per page in the RSS feed for the blog.
PublicTitleStringTrueNoThe header of the blog.
RootURLStringTrueNoThe full URL with domain and scheme to the blog post.
ShowSocialLinkFacebookBooleanTrueNoBoolean indicating if a social link for Facebook should be displayed on the blog.
ShowSocialLinkGoogleBooleanTrueNoBoolean indicating if a social link for Google Plus should be displayed on the blog.
ShowSocialLinkLinkedInBooleanTrueNoBoolean indicating if a social link for LinkedIn should be displayed on the blog.
ShowSocialLinkTwitterBooleanTrueNoBoolean indicating if a social link for Twitter should be displayed on the blog.
SlugStringTrueNoThe path of the URL on which the post will live.
UpdatedAtDatetimeTrueNoWhen the post was last updated.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]LongTrueNoThe blog topic id.
CreatedAtDatetimeTrueNoWhen the topic was created
DeletedAtDatetimeTrueNoWhen the topic was deleted.
DescriptionStringTrueNoA description of the topic.
NameStringTrueNoThe name of the topic.
SlugStringTrueNoHow the topic will appear in the url.
UpdatedAtDatetimeTrueNoWhen the topic was last updated.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]LongTrueNoThe id of the comment.
StateStringTrueNoThe current state of the comment.
PostIdLongTrueBlogPosts.IdNoThe id of the parent blog post.
CommentStringTrueNoThe full text of the comment.
CommentAuthorEmailStringTrueNoEmail address of the user submitting the comment.
CommentAuthorNameStringTrueNoName of the user submitting the comment.
ContentPermalinkStringTrueNoA permanent link for the parent post of the comment.
ContentTitleStringTrueNoThe title of the parent post for the comment.
CreatedAtDatetimeTrueNoWhen the comment was made.
DeletedAtDatetimeTrueNoWhen the comment was deleted.
FirstNameStringTrueNoThe first name of the user who made the comment.
LastNameStringTrueNoThe last name of the user who made the comment.
UserEmailStringTrueNoEmail address of the user submitting the comment.
UserUrlStringTrueNoA url to the user's website if available.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
CompanyId [KEY]LongTrueNoThe id of the company in HubSpot.
IsDeletedBooleanTrueNoA boolean indicating if the company is deleted.
OtherPropertiesStringTrueNoOther properties about the company will dynamically obtained at runtime and will vary depending on the company properties specific to your HubSpot HUB.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Name [KEY]StringFalseNoThe name of the contact property. The name must contain only lowercase alphabetical characters and numbers and must start with a lowercase alphabetical character.
LabelStringFalseNoThe human readable label for the company property that will display in the HubSpot UI.
FieldTypeStringFalseNoThe type of field that will display on the screen for the company property.
TypeStringFalseNoThe stored machine type for the company property.
GroupNameStringFalseContactPropertyGroups.NameNoThe group the company property is a part of.
DescriptionStringFalseNoA description of what the property is for.
DisplayModeStringFalseNoHow the property will be displayed.
DisplayOrderIntegerFalseNoThe order in which the property should be displayed in relation to other properties in the same group.
ExternalOptionsBooleanFalseNoBoolean indicating if there are external options associate with the company property.
IsFormFieldBooleanFalseNoBoolean indicating if the property is a field that is part of a form.
IsCalculatedBooleanFalseNoBoolean indicating if the property is calculated.
IsHiddenBooleanFalseNoBoolean indicating if the property is hidden.
IsHubspotDefinedBooleanFalseNoBoolean indicating if the property is defined by HubSpot.
MutableDefinitionNotDeletableBooleanFalseNoBoolean indicating if the property can be modified but not deleted.
ReadOnlyDefinitionBooleanFalseNoBoolean indicating if the definition for the property is read only.
ReadOnlyValueBooleanFalseNoBoolean indicating if the value of the property is read only.
OptionsAggregateStringFalseNoAn aggregate of additional options for the property. Will have a value if the FieldType is radio, checkbox, or booleancheckbox.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
PropertyNameStringFalseNoThe name of the contact property.
ValueStringFalseNoThe historical value of the property.
TimestampDatetimeFalseNoDatetime when the property was updated
SourceStringFalseNoThe method by which the property was changed
SourceIdStringFalseNoAdditional data realted to the source-type. May not be populated for all source-types.
SourceVidStringFalseNo
CompanyIdStringFalseNoThe Id of the Company that the property belongs to.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Name [KEY]StringFalseNoThe name of the contact property group.
DisplayNameStringFalseNoThe display name of the contact group.
DisplayOrderIntegerFalseNoThe numerical order of the contact group with respect to other contact groups.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
ContactVIDLongFalseContacts.VIDNoThe unique id of the task.
FormIdStringFalseForms.GUIDNoThe GUID of the form that the subission belongs to.
ConversionIdStringFalseNoA Unique ID for the specific form conversion.
PortalIdLongFalseNoThe Portal ID (Hub ID) that the submission belongs to
TimestampDatetimeFalseNoThe time the submission occurred.
TitleStringFalseNoThe title of the page that the form was submitted on.
PageIdLongFalsePages.IdNoId of the page that the form was submitted on.
PageTitleStringFalseNoTitle of the page that the form was submitted on.
PageURLStringFalseNoThe URL that the form was submitted on.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
ContactVIDLongFalseContacts.VIDNoThe unique id for the contact.
TypeStringFalseNoThe type of the identity, one of EMAIL or LEAD_GUID.
ValueStringFalseNoThe value of the identity.
TimestampDatetimeFalseNoTime when the identity was created.
SavedAtDatetimeFalseNoTime when the identity was last updated.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
VID [KEY]LongTrueContacts.VIDNoThe id of the contact on the list.
ListId [KEY]LongTrueContactLists.ListIdNoThe static id of the list.
EmailStringTrueNoThe static id of the list.
TimeAddedToListDatetimeFalseNoThe datetime when the contact was added to the list.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
ListId [KEY]LongTrueNoThe unique id of the list.
NameStringFalseNoThe name of the contact list.
CreatedAtDatetimeTrueNoWhen the contact list was created.
UpdatedAtDatetimeTrueNoWhen the contact list was last updated.
IsDynamicBooleanFalseNoA boolean indicating if the contact list is dynamic.
FiltersAggregateStringFalseNoAn aggregate of filters that a dynamic contact list uses to determine if a newly created contact should be added to the list.
InternalListIdLongTrueNoAn internal id for the contact list.
LastProcessingStateChangeAtDatetimeTrueNoMetadata describing when the last processing state was changed.
ProcessingStateStringTrueNoMetadata indicating the current stage of processing.
LastSizeChangeAtDatetimeTrueNoMetadata describing when the last time the contact list size was changed.
ListSizeLongTrueNoMetadata indicating the size of the contact list.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Name [KEY]StringFalseNoThe name of the contact property. The name must contain only lowercase alphabetical characters and numbers and must start with a lowercase alphabetical character.
LabelStringFalseNoThe human readable label for the contact property that will display in the HubSpot UI.
FieldTypeStringFalseNoThe type of field that will display on the screen for the company property.
TypeStringFalseNoThe stored machine type for the company property.
GroupNameStringFalseContactPropertyGroups.NameNoThe group the company property is a part of.
DescriptionStringFalseNoA description of what the property is for.
DisplayModeStringFalseNoHow the property will be displayed.
DisplayOrderIntegerFalseNoThe order in which the property should be displayed in relation to other properties in the same group.
ExternalOptionsBooleanFalseNoBoolean indicating if there are external options associate with the company property.
IsFormFieldBooleanFalseNoBoolean indicating if the property is a field that is part of a form.
IsCalculatedBooleanFalseNoBoolean indicating if the property is calculated.
IsHiddenBooleanFalseNoBoolean indicating if the property is hidden.
IsFavoritedBooleanFalseNoBoolean indicating if the property is favorited.
FavoritedOrderIntegerFalseNoThe favorited order for this property.
MutableDefinitionNotDeletableBooleanFalseNoBoolean indicating if the property can be modified but not deleted.
ReadOnlyDefinitionBooleanFalseNoBoolean indicating if the definition for the property is read only.
ReadOnlyValueBooleanFalseNoBoolean indicating if the value of the property is read only.
OptionsAggregateStringFalseNoAn aggregate of additional options for the property. Will have a value if the FieldType is radio, checkbox, or booleancheckbox.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
VIDLongFalseContacts.VIDNoThe unique id for the contact.
PropertyNameStringFalseNoThe name of the contact property.
ValueStringFalseNoThe historical value of the property.
TimestampDatetimeFalseNoDatetime when the property was updated
SourceTypeStringFalseNoThe method by which the property was changed
SourceIdStringFalseNoAdditional data realted to the source-type. May not be populated for all source-types.
SourceLabelStringFalseNoAdditional data realted to the source-type. May not be populated for all source-types.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Name [KEY]StringFalseNoThe name of the contact property group.
DisplayNameStringFalseNoThe display name of the contact group.
DisplayOrderIntegerFalseNoThe numerical order of the contact group with respect to other contact groups.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
VID [KEY]LongTrueNoThe unique id for the contact.
ListIdLongTrueNoThe list id the contact is a part of.
SearchTermsStringTrueNoAn input only field representing potential searchterms you would like to specify when selecting contacts.
CanonicalVidLongTrueNoThe cannonical vid associated with the contact.
ProfileTokenStringTrueNoA token for the profile of the contact.
ProfileUrlStringTrueNoA url to the profile of the contact.
IdentityProfilesAggregateStringTrueNoAn aggregate of identities associated with this contact if any.
FormSubmissionsAggregateStringTrueNoAn aggregate of forms submitted by this contact if any.
MergeAuditsAggregateStringTrueNoAn aggregate of merged audits associated with this contact.
MergedVidsAggregateStringTrueNoAn aggregate of merged vids associated with this contact.
OtherPropertiesStringTrueNoOther properties about the contact will dynamically obtained at runtime and will vary depending on the contact properties specific to your HubSpot HUB.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
VID [KEY]LongFalseNoThe unique id for the contact.
ListId [KEY]LongFalseNoThe list id the contact is a part of.
CanonicalVidLongTrueNoThe cannonical vid associated with the contact.
ProfileTokenStringTrueNoA token for the profile of the contact.
ProfileUrlStringTrueNoA url to the profile of the contact.
IdentityProfilesAggregateStringTrueNoAn aggregate of identities associated with this contact if any.
FormSubmissionsAggregateStringTrueNoAn aggregate of forms submitted by this contact if any.
MergeAuditsAggregateStringTrueNoAn aggregate of merged audits associated with this contact.
MergedVidsAggregateStringTrueNoAn aggregate of merged vids associated with this contact.
OtherPropertiesStringTrueNoOther properties about the contact will dynamically obtained at runtime and will vary depending on the contact properties specific to your HubSpot HUB.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
LastNewContactAtStringFalseNoA datetime detailing when the last new contact was added.
ContactsStringFalseNoThe total number of contacts.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
ResultsStringTrueNoThe IDs of objects associated with the given object, based on the specified association type.
FromObjectId [KEY]LongFalseNoThe ID of the object being associated.
ToObjectId [KEY]LongFalseNoThe ID of the object the from object is being associated with.
Category [KEY]StringFalseNoThe category of the association. Currently this must be 'HUBSPOT_DEFINED'.
DefinitionId [KEY]LongFalseNoThe ID of the association definition.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
DealId [KEY]LongFalseDeals.DealIdNoThe Id of the deal.
AssociatedId [KEY]LongFalseNoThe Id of the associated entity.
AssociationType [KEY]StringFalseNoThe type of association such as Company, or Contact.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
PipelineId [KEY]StringTrueNoThe id of the pipeline.
PipelineNameStringFalseNoThe name of the pipeline.
IsActiveBooleanFalseNoA boolean indicating if the pipeline is active or not.
StagesAggregateStringFalseNoThe stages in the pipeline.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
PipelineId [KEY]StringTrueDealPipelines.PipelineIdNoThe id of the pipeline.
StageId [KEY]StringTrueNoThe id of the stage.
PipelineNameStringFalseNoThe name of the pipeline.
PipelineIsActiveBooleanFalseNoA boolean indicating if the pipeline is active or not.
StageNameStringFalseNoThe name of the stage.
StageIsActiveBooleanFalseNoA boolean indicating if the stage is active or not.
StageClosedWonBooleanFalseNoA boolean indicating if the stage indicates that the deal was closed and won.
StageDisplayOrderIntegerFalseNoThe display order of the stage in the deal.
StageProbabilityDoubleFalseNoThe estimated probability of closing the deal at this stage.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Name [KEY]StringFalseNoThe name of the contact property. The name must contain only lowercase alphabetical characters and numbers and must start with a lowercase alphabetical character.
LabelStringFalseNoThe human readable label for the contact property that will display in the HubSpot UI.
FieldTypeStringFalseNoThe type of field that will display on the screen for the company property.
TypeStringFalseNoThe stored machine type for the company property.
GroupNameStringFalseDealPropertyGroups.NameNoThe group the company property is a part of.
DescriptionStringFalseNoA description of what the property is for.
DisplayModeStringFalseNoHow the property will be displayed.
DisplayOrderIntegerFalseNoThe order in which the property should be displayed in relation to other properties in the same group.
ExternalOptionsBooleanFalseNoBoolean indicating if there are external options associate with the company property.
IsFormFieldBooleanFalseNoBoolean indicating if the property is a field that is part of a form.
IsCalculatedBooleanFalseNoBoolean indicating if the property is calculated.
IsHiddenBooleanFalseNoBoolean indicating if the property is hidden.
IsDeletedBooleanTrueNoBoolean indicating if the property has been deleted.
IsHubspotDefinedBooleanTrueNoBoolean indicating if the property is defined by HubSpot.
ShowCurrencySymbolBooleanFalseNoBoolean indicating if the currency symbol should be shown. Only applicable for numbers.
MutableDefinitionNotDeletableBooleanFalseNoBoolean indicating if the property can be modified but not deleted.
ReadOnlyDefinitionBooleanFalseNoBoolean indicating if the definition for the property is read only.
ReadOnlyValueBooleanFalseNoBoolean indicating if the value of the property is read only.
OptionsUpdatableBooleanFalseNoBoolean indicating if the options can be modified.
OptionsAggregateStringFalseNoAn aggregate of additional options for the property. Will have a value if the FieldType is radio, checkbox, or booleancheckbox.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
SourceIdStringFalseNoAdditional data realted to the source-type. May not be populated for all source-types.
SourceVidStringFalseNoA list of vids for related contacts. Only populated if related contacts caused the value to change.
PropertyNameStringFalseNoThe name of the deal property.
ValueStringFalseNoThe historical value of the property.
TimestampDatetimeFalseNoDatetime when the property was updated
SourceStringFalseNoThe method by which the property was changed
DealIdLongFalseNoThe Deal Id of the property.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Name [KEY]StringFalseNoThe name of the contact property group.
DisplayNameStringFalseNoThe display name of the contact group.
DisplayOrderIntegerFalseNoThe numerical order of the contact group with respect to other contact groups.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
DealId [KEY]LongTrueNoThe unique id for the deal.
DealNameStringTrueNoThe name of the deal.
IsDeletedBooleanTrueNoA boolean indicating if the deal has been deleted.
AssociatedCompanyIdsStringTrueNoA comma separated list of company ids associated with the deal.
AssociatedDealIdsStringTrueNoA comma separated list of other deals associated with this deal.
AssociatedVidsStringTrueNoA comma separated list of contact ids associated with this deal.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
DealId [KEY]LongFalseDeals.DealIdNoThe id of the deal.
StageCreated [KEY]DatetimeFalseNoWhen the deal stage was created.
StageNameStringFalseNoThe name of the deal stage.
StageValueStringFalseNoThe value of the deal stage.
StageSourceStringFalseNoThe source of the deal stage.
StageSourceIdStringFalseNoThe source id of the deal stage.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]LongTrueNoThe id of the domain.
CreatedAtDatetimeTrueNoWhen the domain was first created.
DomainStringTrueNoThe actual domain or subdomain.
IsAnyPrimaryBooleanTrueNoTrue if this domain is primary for any category.
IsDNSCorrectBooleanTrueNoTrue if DNS for this domain is optimally configured for use with HubSpot.
IsLegacyDomainBooleanTrueNoTrue is this domain is setup for use with the classic CMS.
IsResolvingBooleanTrueNoTrue if this domain is pointing to HubSpot servers.
ManuallyMarkedAsResolvingBooleanTrueNoTrue if a user manually marked this domain as resolving. This is needed when their is some unique setup or proxy server involved, and the COS can not automatically detect if the domain is properly resolving.
PrimaryBlogPostBooleanTrueNoTrue if this domain is primary for COS blog posts.
PrimaryEmailBooleanTrueNoTrue if this domain is primary for viewing emails as web page.
PrimaryLandingPageBooleanTrueNoTrue if this domain is primary for COS landing pages.
PrimaryLegacyPageBooleanTrueNoTrue if this domain is primary for the classic CMS.
PrimarySitePageBooleanTrueNoTrue if this domain is primary for COS site pages.
SecondaryToDomainStringTrueNoThe name of the domain that this domain redirects to. Only set for non-primary domains.
UpdatedAtDatetimeTrueNoWhen the domain was last updated.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoThe Id of the email campaign event.
CampaignIdStringFalseEmailCampaigns.IdNoCampaign id of the email campaign associated with the event.
TypeStringFalseNoThe type of event.
RecipientEmailStringFalseNoEmail address of the recipient associated with the event.
PortalIdLongFalseNoAn ID referencing the HubSpot account that sent the email message. This will correspond to your account.
AppIdLongFalseNoAn Id referencing the HubSpot Application which sent the email message.
AppNameStringFalseNoThe name of the HubSpot Application which sent the email message. Note that this is a derived value, and may be modified at any time.
CreatedAtDatetimeFalseNoWhen this event was created.
SentByIdStringFalseNoThe Event Id which uniquely identifies the email message's SENT event.
SentByCreatedAtDatetimeFalseNoWhen the email message's SENT event. wich created.
ObsoletedByIdStringFalseNoThe EventId which uniquely identifies the follow-on event which makes this current event obsolete.
ObsoletedByCreatedAtDatetimeFalseNoWhen the event which obsoleted the current event was created.
CausedByIdStringFalseNoThe EventId which uniquely identifies the event which directly caused this event.
CausedByCreatedAtDatetimeFalseNoWhen the event which caused the current event was created.
SubjectStringFalseNoThe subject line of the email message.
FromStringFalseNoThe 'from' field of the email message.
ReplyToStringFalseNoThe 'reply-to' field of the email message.
CcStringFalseNoThe 'cc' field of the email message.
BccStringFalseNoThe 'bcc' field of the email message.
DropReasonStringFalseNoThe reason why the email message was dropped.
DropMessageStringFalseNoThe raw message describing why the email message was dropped. This will usually provide additional details beyond 'dropReason'.
CategoryStringFalseNoThe best-guess of the type of bounce encountered. If an appropriate category couldn't be determined, this property is omitted.
ResponseStringFalseNoThe full response from the recipient's email server.
SmtpIdStringFalseNoAn ID attached to the message by HubSpot.
AttemptIntegerFalseNoThe delivery attempt number.
StatusStringFalseNoThe status code returned from the recipient's email server.
DeviceTypeStringFalseNoThe type of device used that triggered the event if avialable.
HMIDStringFalseNoA randomly-generated Id which corresponds to the header 'X-HubSpot-MID' in the email message.
RefererStringFalseNoThe URL of the webpage that linked to the URL clicked. Whether this is provided, and what its value is, is determined by the recipient's email client.
UrlStringFalseNoThe URL within the message that the recipient clicked.
UserAgentStringFalseNoThe user agent responsible for the event.
BrowserFamilyStringFalseNoThe family of the browser that serviced the event.
BrowserNameStringFalseNoThe name of browser that serviced the event.
BrowserProducerStringFalseNoThe producer of browser that serviced the event.
BrowserProducerUrlStringFalseNoA url to the producer of the browser if available.
BrowserTypeStringFalseNoThe type of browser that produced the event.
BrowserUrlStringFalseNoA url to an entry describing the browser if available.
BrowserVersionStringFalseNoThe versionof browser used.
LocationCityStringFalseNoThe city where the event occurred.
LocationCountryStringFalseNoThe country where the event occurred.
LocationStateStringFalseNoThe state where the event occurred.
FilteredEventBooleanFalseNoA boolean representing whether the event has been filtered out of reporting based on customer reports settings or not.
SourceStringFalseNoThe source of the subscription change.
RequestedByStringFalseNoThe email address of the person requesting the change on behalf of the recipient.
SubscriptionsStringFalseNoThe status of subscriptions for the recipient.
PortalSubscriptionStatusStringFalseNoThe recipient's portal subscription status.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoThe Id of the email campaign.
AppNameStringFalseNoThe name of the app associated with the email campaign.
AppIdLongTrueNoThe Id of the app associated with the email campaign.
LastUpdatedTimeDatetimeTrueNoWhen the email campaign was lasted updated.
NameStringTrueNoThe name of the campaign.
ContentIdLongTrueNoThe ContentId of the email campaign.
NumberBouncedLongTrueNoThe number bounced.
NumberClickLongTrueNoThe number of clicks.
NumberDeferredLongTrueNoThe number deferred.
NumberDeliveredLongTrueNoThe number delivered.
NumberDroppedLongTrueNoThe number dropped.
NumberIncludedLongTrueNoThe number included.
NumberMTADroppedLongTrueNoThe number mta dropped.
NumberOpenLongTrueNoThe number open.
NumberProcessedLongTrueNoThe number processed.
NumberQueuedLongTrueNoThe number queued.
NumberSentLongTrueNoThe number sent.
NumberStatusChangedLongTrueNoThe number where the status was changed.
NumberUnsubscribedLongTrueNoThe number unsubscribed.
ProcessingStateStringTrueNoThe processing state of the email campaign.
TypeStringTrueNoThe type of email campaign.
SubTypeStringTrueNoThe subtype of the email campaign.
SubjectStringTrueNoThe subject of the email campaign.
LastProcessingStartedAtDatetimeTrueNoLast date the email campaign last began processing at.
LastProcessingFinishedAtDatetimeTrueNoWhen the email campaign last finished processing at.
LastProcessingStateChangeAtDatetimeTrueNoThe last time the email campaign's processing state changed.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Email [KEY]StringTrueNoThe email address which has been subscribed.
SubscriptionId [KEY]LongTrueNoThe id of the subscription type.
IsSubscribedBooleanFalseNoBoolean indicating if the customer is subscribed.
ExtraUrlParametersStringFalseNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.
LegalBasisStringFalseNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.
LegalBasisExplanationStringFalseNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.
OptStateStringFalseNoDetermines whether a contact is opted in or out of a given email subscription. If you OPT OUT of all emails or a specific email subscription type for a recipient, there is NO UNDO for this operation. The possible values are OPT_IN, OPT_OUT, and NOT_OPTED.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]LongTrueNoThe Id of the email subscription type.
NameStringFalseNoThe name of the email subscription type.
IsActiveBooleanTrueNoWhether or not the email subscription type is active.
DescriptionStringFalseNoA description for the email subscription type.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]LongTrueNoThe id of the engagement.
PortalIdLongTrueNoThe portal id the engagement is associated with.
IsActiveBooleanTrueNoBoolean indicating if the engagement is active or not.
CreatedAtDatetimeTrueNoWhen the engagement was created.
UpdatedAtDatetimeTrueNoWhen the engagement was last updated.
CreatedByLongTrueNoUser id of the user who created the engagement.
ModifiedByLongTrueNoUser id of the user who lastmodified the engagement.
OwnerIdLongFalseNoThe owner id of the engagement.
TypeStringFalseNoThe type of engagement. Required on inserts.
ActivityTypeStringFalseNoThe activity type of engagement.
DateTimeDatetimeFalseNoA custom datetime that can be specified when inserting the engagement. This can be used for keeping track of something related to the engagement such as when a call was made.
AssociatedContactsStringFalseNoA comma separated list of contact ids associated with the engagement.
AssociatedCompaniesStringFalseNoA comma separated list of company ids associated with the engagement.
AssociatedDealsStringFalseNoA comma separated list of deal ids associated with the engagement.
AssociatedOwnersStringTrueNoA comma separated list of owner ids associated with the engagement.
AssociatedWorkflowsStringFalseNoA comma separated list of workflow ids associated with the engagement.
AssociatedTicketsStringFalseNoA comma separated list of ticket ids associated with the engagement.
AttachmentsStringFalseNoThe attachments associated with this engagement.
MessageIdStringFalseNoThe messageId of an engagement.
ThreadIdStringFalseNoThe threadId of an engagement.
BodyStringFalseNoThe body of an engagement. Only used when Type = NOTE, TASK, PUBLISHING_TASK, CALL, or MEETING.
StatusStringFalseNoThe status of the task. Only used when Type = TASK, CALL, MEETING.
ForObjectTypeStringFalseNoThe object type the task is for. For instance, CONTACT. Only used when Type = TASK.
StartTimeStringFalseNoThe start date time for the meeting. Only used when Type = MEETING.
EndTimeStringFalseNoThe end date time for the meeting. Only used when Type = MEETING.
TitleStringFalseNoThe title of the meeting. Only used when Type = MEETING.
FromEmailStringFalseNoThe from email in the engagement. Only used when Type = EMAIL.
FromFirstNameStringFalseNoThe first name the email was from in the engagement. Only used when Type = EMAIL.
FromLastNameStringFalseNoThe last name the email was from in the engagement. Only used when Type = EMAIL.
ToEmailStringFalseNoA comma separated list of emails the message was sent to. Only used when Type = EMAIL.
CcStringFalseNoA comma separated list of cc'd email addresses. Only used when Type = EMAIL.
BccStringFalseNoA comma separated list of bcc'd email addresses. Only used when Type = EMAIL.
SubjectStringFalseNoThe subject of the email. Only used when Type = EMAIL.
EmailHtmlStringFalseNoHtml content consisting of the body of the email. Only used when Type = EMAIL.
EmailTextStringFalseNoPlain text content consisting of the body of the email. Only used when Type = EMAIL.
CampaignGuidStringFalseNoThe campaign guid of an engagement. Only used when Type = PUBLISHING_TASK.
CategoryStringFalseNoThe category of the engagement. Used when Type = PUBLISHING_TASK.
CategoryIdIntegerFalseNoThe category id of the engagement. Used when Type = PUBLISHING_TASK.
ContentIdStringFalseNoThe content id of the engagement. Used when Type = PUBLISHING_TASK.
StateStringFalseNoThe state of the engagement. Used when Type = PUBLISHING_TASK.
NameStringFalseNoThe name of the engagement. Used when Type = PUBLISHING_TASK.
ToNumberStringFalseNoThe phone number that was called. Used when Type = CALL.
FromNumberStringFalseNoThe phone number that was used as the from number. Used when Type = CALL.
ExternalIdStringFalseNoFor calls made in HubSpot, this will be the internal ID of the call. Used when Type = CALL.
DurationMillisecondsLongFalseNoThe duration of the call in milliseconds. Used when Type = CALL.
ExternalAccountIdStringFalseNoFor calls made in HubSpot, this will be the internal ID of the account used to make the call. Used when Type = CALL.
RecordingUrlStringFalseNoThe URL of the recording file . Used when Type = CALL.
DispositionStringFalseNoInternal GUID that corresponds to the Call Outcome. Used when Type = CALL.
MeetingOutcomeStringFalseNoMeeting outcome. Used when TYPE = MEETING. The allowed values are: SCHEDULED, COMPLETED, RESCHEDULED, NO SHOW, CANCELED.
TaskTypeStringFalseNoTask type. Used when TYPE = TASK. The allowed values are: TODO, EMAIL, CALL.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
EngagementIdLongFalseNoThe id of the engagement.
UUIDStringFalseNoThe scheduled task's uniqe Id.
PortalIdLongFalseNoThe portal id the engagement is associated with.
EngagementTypeStringFalseNoThe type of engagement.
TaskTypeStringFalseNoThe type of the scheduled task.
TimestampDatetimeFalseNoTime when the task was scheduled.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
EngagementIdLongFalseNoThe id of the engagement.
UUIDStringFalseNoThe scheduled task's uniqe Id.
PortalIdIntegerFalseNoThe portal id the engagement is associated with.
EngagementTypeStringFalseNoThe type of engagement.
TaskTypeStringFalseNoThe type of the scheduled task.
TimestampDatetimeFalseNoTime when the task was scheduled.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]LongTrueNoThe id of the contact.
WorkflowId [KEY]LongTrueNoThe id of the workflow.
PortalIdStringTrueNoPortal id for enrollment.
NameStringTrueNoRepresents the name or title associated with the specified workflow.
DescriptionStringTrueNoRepresents the description associated with the specified workflow.
AllowContactToTriggerMultipleTimesBoolTrueNoRepresents whether a contact is allowed to trigger the specified workflow multiple times.
AllowEnrollmentFromMergeBoolTrueNoIndicates if the merging of contacts triggers enrollment. If true, enrollment is enabled when contacts are merged.
EnrollOnCriteriaUpdateBoolTrueNoSpecifies if updates to enrollment criteria trigger enrollment. If true, enrollment is enabled when enrollment criteria are updated.
CanEnrollFromSalesforceBoolTrueNoA setting indicating whether the workflow is available to be seen from the HubSpot embed in Salesforce.
ListeningBoolTrueNoWhether contacts should be unenrolled from the workflow if they are no longer a member of any of the lists used as starting conditions.
EnabledBoolTrueNoRepresents whether the specified workflow enrollment is currently enabled or disabled.
AuthorStringTrueNoInclude details about the user or account responsible for designing and implementing the workflow within the HubSpot platform.
AuthorUserIdLongTrueNoIndicates the unique identifier of the account responsible for creating the workflow.
TypeStringTrueNoIndicate the type or category of the workflow.
IsSegmentBasedBoolTrueNoRepresents whether the workflow is segment-based.
InsertedAtDatetimeTrueNoIndicates the date and time when the contact was inserted or enrolled into the specified workflow.
UpdatedAtDatetimeTrueNoIndicates the date and time when the contact was updated or enrolled into the specified workflow.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringTrueNoThe unique id for the event.
NameStringFalseNoThe name of the evemt.
LabelStringFalseNoThe label of the evemt.
StatusStringFalseNoThe status of the evemt.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]LongTrueNoThe unique id of the file.
NameStringTrueNoThe internal name of the file.
FriendlyUrlStringTrueNoA full url to the file that can be used from a web browser to view or download the file.
AltKeyStringTrueNoAn alternative file key. This is used for creationg the 'alt_url', which is a url for the file that does not include the file id. This is useful if you need to upload a collection of files where their relative location needs to preserved.
AltUrlStringTrueNoThe alternative file URL, without the auto-generated file id in it. This is generated by concatenating the alt_key to the base CDN url.
IsArchivedBooleanTrueNoIf True, the file will not show up in your dashboard, although the file will still be live.
CreatedAtDatetimeTrueNoWhen the file was first created.
DeletedAtDatetimeTrueNoWhen the file was deleted.
ExtensionStringTrueNoThe extension of the file.
FolderIdLongTrueFolders.IdNoThe id of the folder this file is in.
RSUploadedAtDatetimeTrueNoWhen the file was uploaded via RS.
S3UploadedAtDatetimeTrueNoWhen the file was uploaded via S3.
SizeLongTrueNoThe size in bytes of the file.
IsSyncedBooleanTrueNoA boolean indicating if this is a CTA image.
TitleStringTrueNoThe title of the file.
TypeStringTrueNoA string enum for type of the file.
UpdatedAtDatetimeTrueNoWhen the file was last updated.
VersionDoubleTrueNoThe version of the file.
HeightIntegerTrueNoFor images only, the height in pixels of the image.
WidthIntegerTrueNoFor images only, the width in pixels of the image.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]LongTrueNoThe id of the folder.
CategoryIntegerTrueNoThe category of the folder.
CreatedAtDatetimeTrueNoWhen the folder was created.
DeletedAtDatetimeTrueNoWhen the folder was deleted.
FullPathStringTrueNoThe full path to the folder.
NameStringTrueNoThe name of the folder.
ParentFolderIdLongTrueFolders.IdNoThe id of the parent folder for this folder if available.
UpdatedAtDatetimeTrueNoWhen the folder was last updated.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
FormGUIDStringTrueNoThe unique key for the form.
NameStringTrueNoThe name of the field.
DefaultValueStringTrueNoThe default value of the field.
RequiredBooleanTrueNoBoolean indicating wether the field is required in the form.
EnabledBooleanTrueNoBoolean indicating wether the field is enabled.
IsSmartFieldBooleanTrueNoBoolean indicating wether this is a smart field.
LabelStringTrueNoLabel of the field.
GroupNameStringTrueNoName of the group the field belongs to.
SelectedOptionsStringTrueNoThe selected options for the field.
FieldTypeStringTrueNoType of the field.
HiddenBooleanTrueNoBoolean indicating wether the field is hidden.
ValidationStringTrueNo
TypeStringTrueNoValue type of the field.
OptionsStringTrueNoField options
DisplayOrderIntTrueNoDisplay order of the field

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
GUID [KEY]StringTrueNoThe unique key for the form.
NameStringFalseNoThe name of the form.
ActionStringFalseNoAn action to execute when the form is submitted.
CSSClassStringFalseNoThe CSS class associated with the form.
IsDeletableBooleanFalseNoA boolean indicating if the form is deletable.
EmbeddedCodeStringFalseNoEmbedded javascript code included with the form.
FollowUpIdStringFalseNoAn Id to follow up with if available.
IgnoreCurrentValuesBooleanFalseNoA boolean indicating if current or default values should be ignored when submitting the form.
MethodStringFalseNoThe HTTP method to use when submitting the form.
MigratedFromStringTrueNoInformation about where the form was migrated from if available.
NotifyRecipientsStringFalseNoEmail address of recipients that should notified when the form is submitted.
PerformableHTMLStringFalseNoHTML that should be performed on the form.
RedirectStringFalseNoA url to redirect the user to once the form has been submitted.
SubmitTextStringFalseNoThe submit button text.
CreatedAtDatetimeTrueNoWhen the form was created.
UpdatedAtDatetimeTrueNoWhen the form was last updated.
FormFieldGroupsAggregateStringFalseNoA collection of the groups of fields available in the form.
SelectedExternalOptionsAggregateStringFalseNoThe selected external options for the form. This includes the default lifecycle stage which categorizes your contacts and companies while providing context about where they are in your sales and marketing processes.
MetaDataAggregateStringTrueNoA collection of metadata about the form.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
FormGUIDStringTrueNoThe unique key for the form.
PageUrlStringTrueNoUrl of the page.
SubmittedAtDatetimeTrueNoSubmitted time.
NameStringTrueNoName of the submission.
ValueStringTrueNoValue of the submission.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Name [KEY]StringFalseNoThe name of the ticket property. The name must contain only lowercase alphabetical characters and numbers and must start with a lowercase alphabetical character.
LabelStringFalseNoThe human readable label for the ticket property that will display in the HubSpot UI.
FieldTypeStringFalseNoThe type of field that will display on the screen for the company property.
TypeStringFalseNoThe stored machine type for the company property.
GroupNameStringFalseNoThe group the company property is a part of.
DescriptionStringFalseNoA description of what the property is for.
DisplayModeStringFalseNoHow the property will be displayed.
DisplayOrderIntegerFalseNoThe order in which the property should be displayed in relation to other properties in the same group.
ExternalOptionsBooleanFalseNoBoolean indicating if there are external options associate with the company property.
IsFormFieldBooleanFalseNoBoolean indicating if the property is a field that is part of a form.
IsCalculatedBooleanFalseNoBoolean indicating if the property is calculated.
IsHiddenBooleanFalseNoBoolean indicating if the property is hidden.
IsFavoritedBooleanFalseNoBoolean indicating if the property is favorited.
FavoritedOrderIntegerFalseNoThe favorited order for this property.
MutableDefinitionNotDeletableBooleanFalseNoBoolean indicating if the property can be modified but not deleted.
ReadOnlyDefinitionBooleanFalseNoBoolean indicating if the definition for the property is read only.
ReadOnlyValueBooleanFalseNoBoolean indicating if the value of the property is read only.
OptionsAggregateStringFalseNoAn aggregate of additional options for the property. Will have a value if the FieldType is radio, checkbox, or booleancheckbox.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]LongTrueNoThe internal ID for this line item.
NameStringFalseNoThe name for the product for this line item.
PriceStringFalseNoThe price of the line item.
QuantityStringFalseNoThe quantity of the line item.
DescriptionStringFalseNoThe description of the line item.
ProductIdStringFalseNoThe objectId of a product object, and represents the product being sold. It is required when you create a new line item.
VersionIntegerTrueNoThe current version of this line item. This is incremented each time the line item is updated.
IsDeletedBooleanTrueNoBoolean indicating whether or not the line item is deleted. Deleted records will not be included unless you specifically request that deleted records be included.
IncludeDeletedStringFalseYesBy default, deleted records will not be returned by the API. When selecting by Id, you can include this parameter to make sure that records are returned even when they are deleted

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]LongTrueNoThe id of the email.
RssToEmailTimingRepeatsStringFalseNo[ 'instant', 'daily', 'weekly', 'monthly' ]
RssToEmailTimingRepeatsOnMonthlyIntegerFalseNoWhat day of the month should the monthly email be sent [1-31].
RssToEmailTimingRepeatsOnWeeklyIntegerFalseNoWhat day of the week should the weekly email be sent [1=monday - 7=sunday].
RssToEmailTimingSummaryStringFalseNoDescripton. Not used.
RssToEmailTimingTimeStringFalseNoTime the email should be sent at.
AbBooleanTrueNoWhether or not the page is part of an AB test.
AbHoursToWaitIntegerFalseNoOn AB emails, if test results are inconclusive after the specified hours, variation A will be sent.
AbSampleSizeDefaultStringTrueNo['MASTER', 'VARIANT'] if there are less than 1000 recipients, only one variation will be sent.
AbSamplingDefaultStringFalseNo['MASTER', 'VARIANT'] if AB test results are inconclusive in the test group, choose a variation to send (resp. A or B) to the remaining contacts.
AbStatusStringFalseNo['MASTER', 'VARIANT'] determines if the current email is variation A or variation B.
AbSuccessMetricStringFalseNo[ CLICKS_BY_OPENS, CLICKS_BY_DELIVERED, OPENS_BY_DELIVERED ] metric that will be used to determine the winning variation.
AbTestIdStringFalseNoID shared between variation A and B
AbTestPercentageIntegerFalseNoThe size of the test group.
AbVariationBooleanFalseNoDetermines whether the email is a variant or not.
AbsoluteUrlStringFalseNoThe URL of the web version of the email.
AllEmailCampaignIdsStringFalseNoA list of email IDs that are associated with the email.
AnalyticsPageIdStringFalseNoThe ID used to access the analytics page of the email.
AnalyticsPageTypeStringTrueNoAlways 'email' for an email.
ArchivedBooleanFalseNoDetermines whether the email is archived or not.
AuthorStringTrueNoThe email of the user who made the last update to the email.
AuthorAtDatetimeTrueNoTimestamp of the last update to the email in milliseconds.
AuthorEmailStringTrueNoThe email of the user who made the last update to the email.
AuthorNameStringTrueNoThe name of the user who made the last update to the email.
AuthorUserIdLongTrueNoID of the user who made the last update to the email.
BlogEmailTypeStringFalseNo['instant', 'daily', 'weekly', 'monthly'] the cadence for how often blog emails should be sent.
CampaignStringFalseNoThe ID of an email's marketing campaign.
CampaignNameStringFalseNoThe name of the email's marketing campaign.
CanSpamSettingsIdLongFalseNoID used to retrieve the company address, shown in the footer.
CategoryIdIntegerTrueNoThe category ID value, which is always 2 for emails (read only).
ClonedFromLongTrueNoIf the email was cloned, ID of the email it was cloned from.
ContentTypeCategoryIntegerTrueNoThe category ID value, which is always 2 for emails (read only).
CreatePageBooleanFalseNoEnables a web version of the email when set to true.
CreatedDatetimeTrueNoThe timestamp of the email's creation, in milliseconds.
CurrentlyPublishedBooleanFalseNoDetermines the publish status of the email.
DomainStringTrueNoThe domain of the web version of the email. Defaults to the primary domain.
EmailBodyStringFalseNoThe main content of the email within the 'main email body' module.
EmailNoteStringFalseNoOptional email notes, included in the details page of the email.
EmailTypeStringFalseNoType of the email.
FeedbackEmailCategoryStringFalseNo[ 'NPS', 'CES', 'CUSTOM' ] If the email is a feedback email, determines type of feedback email.
FeedbackSurveyIdLongFalseNoThe id of the feedback survey that is linked to the email.
FolderIdLongFalseNoIf the email is in a folder, id of that folder.
FreezeDateDatetimeFalseNoThe publish date or updated date if the email is not published.
FromNameStringFalseNoThe sender name recipients will see (linked to the replyTo address).
HtmlTitleStringFalseNoThe page title of the web version of the email.
IsGraymailSuppressionEnabledBooleanFalseNoIf true, the email will not send to unengaged contacts.
IsLocalTimezoneSendBooleanFalseNoIf true, the email will adjust its send time relative to the recipients timezone.
IsPublishedBooleanFalseNoIf true, the email is in a published state.
LiveDomainStringTrueNoDomain actually used in the web version (read only)
MailingListsExcludedStringTrueNoA list of all contact lists to exclude from the email send.
MailingListsIncludedStringTrueNoA list of all contact lists included in the email send.
MaxRssEntriesLongFalseNoIn blog and recurring emails, the max number of entries to include.
MetaDescriptionStringFalseNoMeta description of the web version of the email, to drive search engine traffic to your page
NameStringFalseNoThe name of the email, as displayed on the email dashboard.
PageExpiryDateDatetimeFalseNoThe expiration date of the web version of an email, in milliseconds.
PageExpiryRedirectIdLongFalseNoThe url of the page the user will be redirected to after the web version of the email expires.
PageRedirectedBooleanFalseNoIndicates if the email's web version has already been set to redirect
PortalIdLongFalseNoThe id of the parent portal.
PreviewKeyStringFalseNoThe preview key used to generate the preview url before the email is published
ProcessingStatusStringFalseNoThe email's processing status.
PublishDateDatetimeFalseNoThe timestamp in milliseconds that the email has been published at, or scheduled to send at.
PublishImmediatelyBooleanFalseNoTrue if the email is not scheduled but will send at publish time.
PublishedAtDatetimeTrueNoIf the email has been published, the time when the publish button has been pressed.
PublishedByIdLongTrueNoIf the email has been published, email of the user that pressed the publish button.
PublishedByNameStringTrueNoIf the email has been published, name of the user that pressed the publish button.
PublishedUrlStringTrueNoAbsoluteUrl, only if the email is currentlyPublished
ReplyToStringFalseNoThe email address the recipient will see and reply to.
ResolvedDomainStringTrueNoThe domain used in the web version: either the primary one or the one set in the domain field.
RssEmailAuthorLineTemplateStringFalseNoText shown before the 'author_line' tag in blog and RSS email's items.
RssEmailBlogImageMaxWidthIntegerFalseNoThe max width for blog post images in RSS emails.
RssEmailByTextStringFalseNoIf rssEmailAuthorLineTemplate is not set, word before the author name in blog and RSS email's items.
RssEmailClickThroughTextStringFalseNoText shown on the link to see the full post in blog and RSS email's items.
RssEmailCommentTextStringFalseNoText shown on the link to comment the post in blog and RSS email's items.
RssEmailEntryTemplateStringFalseNoOptional, custom template for every RSS entry.
RssEmailEntryTemplateEnabledBooleanFalseNoDetermines if the Entry Template is used for an RSS email.
RssEmailUrlStringFalseNoURL used for social sharing.
SlugStringFalseNoPath of the web version URL.
SubcategoryStringFalseNoSubcategory.
SubjectStringFalseNoThe subject of the email.
SubscriptionLongFalseNoThe id of the email's subscription type.
SubscriptionBlogIdLongFalseNoFor blog emails, id of the linked blog.
SubscriptionNameStringFalseNoThe name of the email's subscription type.
TemplatePathStringFalseNoThe path of the email's body template within the design manager.
TransactionalBooleanTrueNoDetermines whether the email is a transactional email or not.
UnpublishedAtDatetimeFalseNoThe timestamp in milliseconds of when the email was unpublished.
UpdatedDatetimeTrueNoTimestamp of the last update in milliseconds.
UpdatedByIdLongTrueNoThe ID of the last user who updated the email.
UrlStringTrueNoThe web version URL
UseRssHeadlineAsSubjectBooleanFalseNoSetting for RSS emails, uses the latest RSS entry as the email subject.
WidgetsStringTrueNoThe content of layout sections of the email (widgets).
VidsExcludedStringTrueNoA list of contact IDs to exclude from being sent the email.
VidsIncludedStringTrueNoA list of contacts IDs to include in the email send.
WorkflowNamesStringTrueNoA list of all linked workflows to this email.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]LongTrueNoThe id of the page.
ArchivedInDashboardBooleanTrueNoIf True, the page will not show up in your dashboard, although the page will still be live.
CampaignIdStringTrueEmailCampaigns.IdNoThe guid of the marketing campaign this page is associated with.
CampaignNameStringTrueEmailCampaigns.NameNoThe name of the marketing campaign this page is associated with.
CreatedAtDatetimeTrueNoWhen the page was created.
CurrentLiveDomainStringTrueNoThe domain this page is currently located on.
ArchivedAtDatetimeTrueNoWhen the page was deleted
FooterHTMLStringTrueNoCustom HTML for embed codes, javascript that should be placed before the body tag of the page
HeaderHTMLStringTrueNoCustom HTML for embed codes, javascript, etc. that goes in the head tag of the page
IsDraftBooleanTrueNoTrue if the post is still a draft, invisible to the public. Gets changed when the /publish-action API endpoint is called.
MetaDescriptionStringTrueNoA description that goes in meta tag on the page
MetaKeywordsStringTrueNoKeywords for the meta tag.
NameStringTrueNoThe internal name of the page.
PasswordStringTrueNoSet this to create a password protected page. Entering the password will be required to view the page.
PublishDateDatetimeTrueNoThe date the page is to be published at in milliseconds since the unix epoch.
SlugStringTrueNoThe path of the URL on which the page will live. Changing this will change the URL.
StyleOverrideIdStringTrueNoThe ID of the style to use for this page, set this to use a different style than the default style for the site.
SubcategoryStringTrueNoThis is set to empty or to
UpdatedAtDatetimeTrueNoWhen the page was last updated.
UrlStringTrueNoThe full URL with domain and scheme to the page. Will return a 404 if the page is not yet published.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Name [KEY]StringFalseNoThe name of the ticket property. The name must contain only lowercase alphabetical characters and numbers and must start with a lowercase alphabetical character.
LabelStringFalseNoThe human readable label for the ticket property that will display in the HubSpot UI.
FieldTypeStringFalseNoThe type of field that will display on the screen for the company property.
TypeStringFalseNoThe stored machine type for the company property.
GroupNameStringFalseNoThe group the company property is a part of.
DescriptionStringFalseNoA description of what the property is for.
DisplayModeStringFalseNoHow the property will be displayed.
DisplayOrderIntegerFalseNoThe order in which the property should be displayed in relation to other properties in the same group.
ExternalOptionsBooleanFalseNoBoolean indicating if there are external options associate with the company property.
IsFormFieldBooleanFalseNoBoolean indicating if the property is a field that is part of a form.
IsCalculatedBooleanFalseNoBoolean indicating if the property is calculated.
IsHiddenBooleanFalseNoBoolean indicating if the property is hidden.
IsFavoritedBooleanFalseNoBoolean indicating if the property is favorited.
FavoritedOrderIntegerFalseNoThe favorited order for this property.
MutableDefinitionNotDeletableBooleanFalseNoBoolean indicating if the property can be modified but not deleted.
ReadOnlyDefinitionBooleanFalseNoBoolean indicating if the definition for the property is read only.
ReadOnlyValueBooleanFalseNoBoolean indicating if the value of the property is read only.
OptionsAggregateStringFalseNoAn aggregate of additional options for the property. Will have a value if the FieldType is radio, checkbox, or booleancheckbox.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]LongTrueNoThe internal ID for this product.
NameStringFalseNoThe name of the product.
SkuStringFalseNoThe SKU of the product.
PriceStringFalseNoThe price of the product.
DescriptionStringFalseNoThe description of the product.
VersionIntegerTrueNoThe current version of the product. This is incremented each time the product is updated.
IsDeletedBooleanFalseNoBoolean indicating whether or not the product is deleted. Deleted records will not be included unless you specifically request that deleted records be included.
IncludeDeletedStringFalseYesBy default, deleted records will not be returned by the API. When selecting by Id, you can include this parameter to make sure that records are returned even when they are deleted

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
ChannelGUID [KEY]StringTrueNoThe social media channel GUID.
AccountGUIDStringFalseNoThe account GUID associated with the social media channel.
AccountSlugStringFalseNoThe account slug.
AccountTypeStringFalseNoThe type of account.
IsActiveBooleanFalseNoA boolean indicating if the channel is active.
AutoPublishBooleanFalseNoA boolean indicating if messages should be automatically published to the channel.
AvatarUrlStringFalseNoA url to the avatar for your account on the social medial channel.
ChannelIdStringFalseNoThe id for the channel on the social media site.
ChannelKeyStringFalseNoA HubSpot key associated with the channel.
ChannelSlugStringFalseNoThe slug associated with the channel.
CreatedAtDatetimeTrueNoWhen the channel was created.
FollowMeBooleanFalseNoA boolean indicating if the channel should be followed.
IsHiddenBooleanFalseNoA boolean indicating if the channel is hidden.
MonitoringBooleanFalseNoA boolean indicating if the channel should be monitored.
ReachBooleanFalseNoA boolean indicating if tracking the growth of followers on this account over time should be enabled.
ReachTypeStringFalseNoThe type of reach for this social media channel.
IsSharedBooleanFalseNoA boolean indicating if this social media channel is shared.
TypeStringFalseNoThe type of social media channel.
UpdatedAtDatetimeTrueNoWhen this social media channel was last updated.
UserNameStringFalseNoThe user name for the social media channel.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
MessageGUID [KEY]StringTrueNoThe Id of the social media message.
ContentBodyStringFalseNoThe body of the content for the message.
ContentOriginalBodyStringFalseNoThe original body of the content for the message if it has been altered.
ContentPhotoUrlStringFalseNoThe photo associatedwith the message.
ContentUncompressedLinksStringFalseNoAny uncompressed links associated with the message.
TriggerAtDatetimeFalseNoWhen to trigger the social media message.
ChannelStringTrueNoThe social media channel the message will be posted to.
ChannelGUIDStringFalseNoThe social media channel GUID.
CampaignGUIDStringTrueNoThe campaign GUID associated with the social media message.
CampaignNameStringTrueNoThe campaign name associated with the social media message.
ClicksLongTrueNoThe number of clicks HubSpot has recorded for the links in the social media message.
ClientTagStringTrueNoClient tags associated with the social media message.
CreatedAtDatetimeTrueNoWhen the social media message was created.
CreatedByLongTrueNoAn integer indicating which user created the social mdia message.
FinishedAtDatetimeTrueNoWhen the social media message was finished posting.
ForeignIdStringTrueNoAn optional ForeignId associated with the social media message.
GroupGUIDStringTrueNoThe group GUID associated with the social media message.
IsFailedBooleanTrueNoA boolean indicating if the message has failed to post.
IsPendingBooleanTrueNoA boolean indicating if the message is pending a post.
IsPublishedBooleanTrueNoA boolean indicating if the message has been posted.
IsRetryBooleanTrueNoA boolean indicating if the message is being retried.
MessageStringTrueNoThe message that came back from the social media site if any. This may contain an error message if the social media message failed if the status is ERROR_FATAL.
MessageUrlStringTrueNoA url associated with the message that came back from the social media site. This may simply be a link to the social media posting if the status is SUCCESS.
RemoteContentIdStringTrueNoA remote content id if any.
RemoteContentTypeStringTrueNoThe remote content type if any.
StatusStringTrueNoThe current status of the social media message.
UpdatedByLongTrueNoAn integer indicating who last updated the social media message.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]LongTrueNoThe id of the template.
CategoryIdLongTrueNoThe category of content this template can be used for. 1 for landing page, 2 for email, 3 for site page.
CDNMinifiedUrlStringTrueNoFor javascript and css, this is the URL of the version of the content that has been rendered, minified, and uploaded to our Content Delivery Network.
CDNUrlStringTrueNoFor non-html templates, the URL to the version of the template that has been rendered and uploaded to the HubSpot CDN.
DeletedAtDatetimeTrueNoWhen the template was deleted.
FolderStringTrueNoThe folder this template lives in.
GeneratedFromLayoutIdStringTrueNoThe id of the layout that generated this template.
IsAvailableForNewContentBooleanTrueNoTrue if this template will show up in the content creation screen.
IsFromLayoutBooleanTrueNoTrue if template was generated by publishing a layout.
IsReadOnlyBooleanTrueNoTrue if the template can only be read.
LabelStringTrueNoThe label of the template as it shows up in the template builder.
PathStringTrueNoThe path of the template, as should be used for HubL include statements.
SourceStringTrueNoThe markup of the template.
ThumbnailPathStringTrueNoThe thumbnail image of the template.
UpdatedAtDatetimeTrueNoWhen the template was last updated.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Name [KEY]StringFalseNoThe name of the ticket property. The name must contain only lowercase alphabetical characters and numbers and must start with a lowercase alphabetical character.
LabelStringFalseNoThe human readable label for the ticket property that will display in the HubSpot UI.
FieldTypeStringFalseNoThe type of field that will display on the screen for the company property.
TypeStringFalseNoThe stored machine type for the company property.
GroupNameStringFalseNoThe group the company property is a part of.
DescriptionStringFalseNoA description of what the property is for.
DisplayModeStringFalseNoHow the property will be displayed.
DisplayOrderIntegerFalseNoThe order in which the property should be displayed in relation to other properties in the same group.
ExternalOptionsBooleanFalseNoBoolean indicating if there are external options associate with the company property.
IsFormFieldBooleanFalseNoBoolean indicating if the property is a field that is part of a form.
IsCalculatedBooleanFalseNoBoolean indicating if the property is calculated.
IsHiddenBooleanFalseNoBoolean indicating if the property is hidden.
IsFavoritedBooleanFalseNoBoolean indicating if the property is favorited.
FavoritedOrderIntegerFalseNoThe favorited order for this property.
MutableDefinitionNotDeletableBooleanFalseNoBoolean indicating if the property can be modified but not deleted.
ReadOnlyDefinitionBooleanFalseNoBoolean indicating if the definition for the property is read only.
ReadOnlyValueBooleanFalseNoBoolean indicating if the value of the property is read only.
OptionsAggregateStringFalseNoAn aggregate of additional options for the property. Will have a value if the FieldType is radio, checkbox, or booleancheckbox.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Name [KEY]StringFalseNoThe name of the contact property group.
DisplayNameStringFalseNoThe display name of the contact group.
DisplayOrderIntegerFalseNoThe numerical order of the contact group with respect to other contact groups.
IsHubspotDefinedBooleanTrueNoIndicator whether or not this field is defined in the Hubspot.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]LongFalseNoThe internal ID for this ticket.
PortalIdLongFalseNoThe Portal or Hub ID that this object belongs to.
VersionLongFalseNoVersion of the ticket.
IsDeletedBooleanFalseNoWhether or not the ticket is deleted. Deleted records will not be included unless you specifically request that deleted records be included.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]LongTrueNoThe id of the url mapping.
CreatedAtDatetimeTrueNoWhen the url mapping was created.
DeletedAtDatetimeTrueNoWhen the url mapping was deleted.
DestinationStringTrueNoThe URL to redirect to.
IsMatchFullUrlBooleanTrueNoIf true, the 'route_prefix' should match on the entire URL including the domain.
IsMatchQueryStringBooleanTrueNoIf true, the 'route_prefix' should match on the entire URL path including the query string.
IsOnlyAfterNotFoundBooleanTrueNoIf True, the URL mapping will only be applied if a live page matching the URL is not found. If False, the URL mapping will take precedence over any existing page.
PrecedenceIntegerTrueNoIf a URL matches more than one mapping, the one with the lower precedence applies.
RoutePrefixStringTrueNoThe incoming URL to match.
UpdatedAtDatetimeTrueNoWhen the url mapping was last updated.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]LongTrueNoThe Id of the workflow.
NameStringFalseNoThe name of the workflow.
DescriptionStringFalseNoA description of the workflow.
IsEnabledBooleanFalseNoA boolean indicating if this workflow is enabled.
CreatedAtDatetimeTrueNoWhen the workflow was created.
UpdatedAtDatetimeTrueNoWhen the workflow was last updated.
AllowContactToTriggerMultipleTimesBooleanFalseNoA boolean indicating if the workflow can be triggered for the same contact multiple times.
CanEnrollFromSalesforceBooleanFalseNoA boolean indicating if contacts can be enrolled to this workflow from Salesforce.
IsInternalBooleanFalseNoA boolean indicating if the workflow is internal.
LegacyCampaignIdLongFalseNoThe campaign id associated with the workflow if available.
LegacyMigrationBooleanFalseNoA boolean indicating if the workflow was migrated from the legacy lead nurturing tool.
IsListeningBooleanFalseNoA boolean indicating if the workflow is listening or active.
ContactListIdsCompletedLongTrueNoID of the completed contact list associated with the workflow.
ContactListIdsEnrolledLongTrueNoID of the enrolled contact list associated with the workflow.
ContactListIdsSucceededLongTrueNoID of the contact list that successfully completed the workflow.
ContactListIdsActiveLongTrueNoID of the active contact list associated with the workflow.
StepsAggregateStringFalseNoAn aggregate of the steps to take when executing this workflow.
SupresssionSettingsAggregateStringFalseNoAn aggregate of supression properties for this workflow.
TriggersAggregateStringFalseNoAn aggregate of triggers for this workflow.
UnenrollmentSettingTypeStringFalseNoThe type of unenrollment setting for this workflow.
UnenrollmentSettingExcludedWorkflowsAggregateStringFalseNoAn workflows to exclude a contact from if they enroll in this workflow.
GoalListAggregateStringFalseNoAn aggregate of goal ids for this workflow.
ExtraUrlParametersStringTrueNoAn input only property for specifying additional parameters when selecting data from HubSpot. Specify the parameters as name=value pairs in a comma separated list. For instance, 'param1=value1,param2=value2,param3=value3'.

Return to Top