Contacts

Retrieve the available Contacts in HubSpot. This table supports both OAuth and APIKey authentications.

Table Specific Information

In HubSpot, contacts store information about an individual. From marketing automation to smart content, the lead-specific data found in contact records helps users leverage much of HubSpot's functionality.

Select

When selecting contacts, they can be filtered by columns marked below as 'Filterable'. For those columns, the supported server-side operators are =, !=, <, <=, >, >=. Further filtering is available using AND and OR combinations. A maximum of 2 OR operators are supported server-side, with each of these operators supporting up to 2 AND operators inside of them. For example: 

SELECT * FROM Contacts WHERE [Associated Deals] = 3 AND [First Deal Created Date] > '2019-01-01'
SELECT * FROM Contacts WHERE [Company Name] = 'CData' OR [Last Name] = 'Robinson'

In the below server-offloading examples, "{Column}" represents any column you'd like to filter and "{Value}" represents any value you want to filter it on: 

SELECT * FROM Contacts WHERE {Column} = {Value} AND {Column} < {Value} AND {Column} > {Value}
SELECT * FROM Contacts WHERE {Column} != {Value} AND {Column} >= {Value} AND {Column} <= {Value}
SELECT * FROM Contacts WHERE ({Column} = {Value} AND {Column} = {Value}) OR ({Column} != {Value} AND {Column} >= {Value})
SELECT * FROM Contacts WHERE ({Column} != {Value} AND {Column} >= {Value} AND {Column} <= {Value}) OR ({Column} != {Value} AND {Column} >= {Value} AND {Column} <= {Value}) OR ({Column} != {Value} AND {Column} >= {Value} AND {Column} <= {Value})

Insert


INSERT INTO Contacts([Field of study]) VALUES('uni')

Update


UPDATE Contacts SET [Field of study] = 'new uni' WHERE ID='25151'

Delete


DELETE FROM Contacts WHERE ID='25151'

Columns

Name Type ReadOnly References Filterable Description
Id [KEY] Long False True

Unique identifier of the contact.
Archived Bool True False

Whether the contact is archived or not.
CreatedAt Datetime True False

When the contact was created.
UpdatedAt Datetime True False

When the contact was last updated.
Company_size String False True

A contact's company size. This property is required for the Facebook Ads Integration. This property will be automatically synced via the Lead Ads tool
Date_of_birth String False True

A contact's date of birth. This property is required for the Facebook Ads Integration. This property will be automatically synced via the Lead Ads tool
Days_To_Close Double True True

The days that elapsed from when a contact was created until they closed as a customer. This is set automatically by HubSpot and can be used for segmentation and reporting.
Degree String False True

A contact's degree. This property is required for the Facebook Ads Integration. This property will be automatically synced to via Lead Ads tool
Field_of_study String False True

A contact's field of study. This property is required for the Facebook Ads Integration. This property will be automatically synced via the Lead Ads tool
First_Conversion_Date Datetime True True

The date this contact first submitted a form
First_Conversion String True True

The first form this contact submitted
First_Deal_Created_Date Datetime True True

The date the first deal for a contact was created. This is automatically set by HubSpot and can be used for segmentation and reporting.
Gender String False True

Graduation_date String False True

A contact's graduation date. This property is required for the Facebook Ads Integration. This property will be automatically synced via the Lead Ads tool
Additional_email_addresses String True True

A set of additional email addresses for a contact
All_vids_for_a_contact String True True

A set of all vids, canonical or otherwise, for a contact
First_Touch_Converting_Campaign String True True

The campaign responsible for the first touch creation of this contact
Last_Touch_Converting_Campaign String True True

The campaign responsible for the last touch creation of this contact
Buying_Role String False True

The role that a contact plays during the sales process. Contacts can have more than one role, and they can share the same role with another contact.
All_form_submissions_for_a_contact String True True

A set of all form submissions for a contact
Merged_vids_with_timestamps_of_a_contact String True True

Merged vids with timestamps of a contact
Calculated_Mobile_Number_in_International_Format String True True

Mobile number in international format
Calculated_Phone_Number_in_International_Format String True True

Phone number in international format
Calculated_Phone_Number_Area_Code String True True

Area Code of the calculated phone number
Calculated_Phone_Number_Country_Code String True True

Country code of the calculated phone number
Calculated_Phone_Number_Region String True True

ISO2 Country code for the derived phone number
Email_Confirmed Bool True True

Email Confirmation status of user of Content Membership
Membership_Notes String False True

The notes relating to the contact's content membership.
Registered_At Datetime True True

Datetime at which this user was set up for Content Membership
Domain_to_which_registration_email_was_sent String True True

Domain to which the registration invitation email for Content Membership was sent to
Time_registration_email_was_sent Datetime True True

Datetime at which this user was sent a registration invitation email for Content Membership
Status String False True

The status of the contact's content membership.
Conversations_visitor_email String True True

A Conversations visitor's email address
Created_By_Conversations Bool True True

Flag indicating this contact was created by the Conversations API
Created_by_user_ID Double True True

The user that created this object. This value is automatically set by HubSpot and may not be modified.
Object_create_date_time Datetime True True

The date and time at which this object was created. This value is automatically set by HubSpot and may not be modified.
Recent_Document_Revisit_Date Datetime True True

The last time a shared document (presentation) was accessed by this contact
Email_Domain String True True

A contact's email address domain
Email_Address_Quarantined Bool True True

Indicates that the current email address has been quarantined for anti-abuse reasons and any marketing email sends to it will be blocked. This is automatically set by HubSpot.
Email_Address_Quarantined_Reason String True True

The reason why the email address has been quarantined. This is automatically set by HubSpot.
Email_Address_Recipient_Fatigue_Next_Available_Sending_Time Datetime True True

When this recipient has reached the limit of email sends per time period, this property indicates the next available time to send. This is automatically set by HubSpot.
Sends_Since_Last_Engagement Double True True

The number of marketing emails that have been sent to the current email address since the last engagement (open or link click). This is automatically set by HubSpot.
Marketing_email_confirmation_status String True True

The status of a contact's eligibility to receive marketing email. This is automatically set by HubSpot.
Clicked_Facebook_ad Bool False True

Whether contact has clicked a Facebook ad
Facebook_ID String False True

A contact's facebook id
Last_NPS_survey_comment String True True

Last NPS survey comment that this contact gave
Last_NPS_survey_rating String True True

Last NPS survey rating that this contact gave
Last_NPS_survey_date Datetime True True

The time that this contact last submitted a NPS survey response. This is automatically set by HubSpot.
Should_be_shown_an_NPS_web_survey Bool False True

Whether or not a contact should be shown an NPS web survey. This is automatically set by HubSpot.
Google_ad_click_id String False True

googleplus_ID String False True

A contact's googleplus id
IP_Timezone String True True

The timezone reported by a contact's IP address. This is automatically set by HubSpot and can be used for segmentation and reporting.
Is_a_contact Bool True True

Is a contact, has not been deleted and is not a visitor
Last_Sales_Activity_Date Datetime True True

The date of the last sales activity with the contact. This property is set automatically by HubSpot. Note: This field is only updated for contacts with an owner.
Object_last_modified_date_time Datetime True True

The date and time at which this object was last modified. This value is automatically set by HubSpot and may not be modified.
Lead_Status String False True

The contact's sales, prospecting or outreach status
Legal_basis_for_processing_contact_s_data String False True

Legal basis for processing contact's data; 'Not applicable' will exempt the contact from GDPR protections
Linkedin_ID String False True

A contact's linkedin id
Marketable_Reason_ID String True True

The ID of the activity that made a contact marketable
Marketable_Reason_Type String True True

The type of the activity that made a contact marketable
Marketable_Status String True True

The marketable status of a contact
Marketing_Ineligible_on_Renewal String True True

If this contact will be no longer marketable on renewal
Merged_object_IDs String True True

The list of object IDs that have been merged into this object. This value is automatically set by HubSpot and may not be modified.
Contact_ID Double True True

The unique ID for this contact. This unique ID is automatically populated by HubSpot and cannot be changed.
Likelihood_to_close Double True True

The probability that a contact will become a customer within the next 90 days. This score is based on standard contact properties and behavior.
Contact_priority String True True

A ranking system of contacts evenly assigned into four tiers. Contacts in tier one are more likely to become customers than contacts in tier four.
Recent_Sales_Email_Clicked_Date Datetime True True

The last time a tracked sales email was clicked by this user
Recent_Sales_Email_Opened_Date Datetime True True

The last time a tracked sales email was opened by this contact. This property does not update for emails that were sent to more than one contact.
Calculated_Mobile_Number_with_country_code String True True

Mobile number with country code
Calculated_Phone_Number_with_country_code String True True

Phone number with country code
Calculated_Mobile_Number_without_country_code String True True

Mobile number without country code
Calculated_Phone_Number_without_country_code String True True

Phone number without country code
Currently_in_Sequence Bool True True

A yes/no field that indicates whether the contact is currently in a Sequence.
Twitter_ID String False True

A contact's twitter id
Updated_by_user_ID Double True True

The user that last updated this object. This value is automatically set by HubSpot and may not be modified.
Owner_Assigned_Date Datetime True True

The most recent date a HubSpot Owner was assigned to a contact. This is set automatically by HubSpot and can be used for segmentation and reporting.
IP_City String True True

The city reported by a contact's IP address. This is automatically set by HubSpot and can be used for segmentation and reporting.
IP_Country String True True

The country reported by a contact's IP address. This is automatically set by HubSpot and can be used for segmentation and reporting.
IP_Country_Code String True True

The country code reported by a contact's IP address. This is automatically set by HubSpot and can be used for segmentation and reporting.
IP_Latitude_Longitude String True True

IP_State_Region String True True

The state or region reported by a contact's IP address. This is automatically set by HubSpot and can be used for segmentation and reporting.
IP_State_Code_Region_Code String True True

The state code or region code reported by a contact's IP address. This is automatically set by HubSpot and can be used for segmentation and reporting.
IP_Zipcode String True True

The zipcode reported by a contact's IP address. This is automatically set by HubSpot and can be used for segmentation and reporting.
Job_function String False True

A contact's job function. This property is required for the Facebook Ads Integration. This property will be automatically synced via the Lead Ads tool
Last_Modified_Date Datetime True True

The date any property on this contact was modified
Marital_Status String False True

A contact's marital status. This property is required for the Facebook Ads Integration. This property will be automatically synced via the Lead Ads tool
Military_status String False True

A contact's military status. This property is required for the Facebook Ads Integration. This property will be automatically synced via the Lead Ads tool
Associated_Deals Double True True

The number of deals associated with this contact. This is set automatically by HubSpot.
Number_of_Form_Submissions Double True True

The number of forms this contact has submitted
Number_of_Unique_Forms_Submitted Double True True

The number of different forms this contact has submitted
Recent_Conversion_Date Datetime True True

The date this contact last submitted a form
Recent_Conversion String True True

The last form this contact submitted
Recent_Deal_Amount Double True True

The amount of the last closed won deal associated with a contact. This is set automatically by HubSpot based on information from the Deals object.
Recent_Deal_Close_Date Datetime True True

The date that the last deal associated with a contact was won. This is automatically set by HubSpot based on information from the Deals object.
Relationship_Status String False True

A contact's relationship status. This property is required for the Facebook Ads Integration. This property will be automatically synced via the Lead Ads tool
School String False True

A contact's school. This property is required for the Facebook Ads Integration. This property will be automatically synced via the Lead Ads tool
Seniority String False True

A contact's seniority. This property is required for the Facebook Ads Integration. This property will be automatically synced via the Lead Ads tool
Start_date String False True

A contact's start date. This property is required for the Facebook Ads Integration. This property will be automatically synced via the Lead Ads tool
Total_Revenue Double True True

The sum from all closed won deal revenue associated with a contact. This is automatically set by HubSpot and can be used for segmentation and reporting.
Work_email String False True

A contact's work email. This property is required for the Facebook Ads Integration. This property will be automatically synced via the Lead Ads tool
Default_HubSpot_Blog_Email_Subscription String False True

First_Name String False True

A contact's first name
First_Page_Seen String True True

The first page a contact saw on your website. This is automatically set by HubSpot for each contact.
Marketing_emails_delivered Double True True

The number of marketing emails delivered for the current email address. This is automatically set by HubSpot.
Opted_out_of_emailMarketing_Information String True True

Indicates that the current email address has opted out of this email type.
Opted_out_of_emailOne_to_One String True True

Indicates that the current email address has opted out of this email type.
Opted_out_of_emailDefault_HubSpot_Blog_Subscription String True True

Indicates that the current email address has opted out of this email type.
Opted_out_of_emailCustomer_Service_Communication String True True

Indicates that the current email address has opted out of this email type.
Twitter_Username String False True

The contact's Twitter handle. This is set by HubSpot using the contact's email address.
Currently_in_workflow String True True

If the contact is currently enrolled in any workflow
Follower_Count Double False True

The number of Twitter followers a contact has
Last_Page_Seen String True True

The last page a contact saw on your website. This is automatically set by HubSpot for each contact.
Marketing_emails_opened Double True True

The number of marketing emails opened for the current email address. This is automatically set by HubSpot.
Last_Name String False True

A contact's last name
Number_of_Pageviews Double True True

The sum of all pages a contact has seen on your website. This is automatically set by HubSpot for each contact.
Marketing_emails_clicked Double True True

The number of marketing emails which have had link clicks for the current email address. This is automatically set by HubSpot.
Salutation String False True

The title used to address a contact
Twitter_Profile_Photo String False True

The contact's Twitter profile photo. This is set by HubSpot using the contact's email address.
Email String False True

A contact's email address
Number_of_Sessions Double True True

The sum of all sessions a contact has made to your website. This is automatically set by HubSpot for each contact.
Marketing_emails_bounced Double True True

The number of marketing emails that bounced for the current email address. This is automatically set by HubSpot.
Persona String False True

A contact's persona
Most_Recent_Social_Click Datetime True True

The date of the most recent click on a published social message. This is set automatically by HubSpot for each contact.
Number_of_event_completions Double True True

The sum of all events a contact has experienced. This is automatically set by HubSpot for each contact.
Unsubscribed_from_all_email Bool True True

Indicates that the current email address has opted out of all email.
Twitter_Clicks Double True True

The number of times a contact clicked on links you shared on Twitter through HubSpot. This is set automatically by HubSpot and can be used for segmentation.
Mobile_Phone_Number String False True

A contact's mobile phone number
Phone_Number String False True

A contact's primary phone number
Fax_Number String False True

A contact's primary fax number
Time_First_Seen Datetime True True

The first time a contact has been seen. This is automatically set by HubSpot for each contact.
Last_marketing_email_name String True True

The name of the last marketing email sent to the current email address. This is automatically set by HubSpot.
Last_marketing_email_send_date Datetime True True

The date of the most recent delivery for any marketing email to the current email address. This is automatically set by HubSpot.
Facebook_Clicks Double True True

The number clicks on links shared on Facebook
Street_Address String False True

A contact's street address, including apartment or unit #
Date_of_last_meeting_booked_in_meetings_tool Datetime True True

The date of the most recent meeting a contact has booked through the meetings tool.
Campaign_of_last_booking_in_meetings_tool String True True

This UTM parameter shows which marketing campaign (e.g. a specific email) referred the contact to the meetings tool for their most recent booking. This property is only populated when you add tracking parameters to your meeting link.
Medium_of_last_booking_in_meetings_tool String True True

This UTM parameter shows which channel (e.g. email) referred the contact to the meetings tool for their most recent booking. This property is only populated when you add tracking parameters to your meeting link.
Source_of_last_booking_in_meetings_tool String True True

This UTM parameter shows which site (e.g. Twitter) referred the contact to the meetings tool for their most recent booking. This property is only populated when you add tracking parameters to your meeting link.
Time_of_First_Session Datetime True True

The first time a contact visited your website. This is automatically set by HubSpot for each contact.
Last_marketing_email_open_date Datetime True True

The date of the most recent open for any marketing email to the current email address. This is automatically set by HubSpot.
Latest_meeting_activity Datetime True True

The date of the most recent meeting (past or upcoming) logged for, scheduled with, or booked by this contact.
Recent_Sales_Email_Replied_Date Datetime True True

The last time a tracked sales email was replied to by this user. This is set automatically by HubSpot based on user actions in the contact record.
LinkedIn_Clicks Double True True

The number clicks on links shared on LinkedIn
Contact_owner String False True

The owner of a contact. This can be any HubSpot user or Salesforce integration user, and can be set manually or via Workflows.
Last_Contacted Datetime True True

The last time a call, email, or meeting was logged for a contact. This is set automatically by HubSpot based on user actions in the contact record.
Last_Activity_Date Datetime True True

The last time a note, call, email, meeting, or task was logged for a contact. This is set automatically by HubSpot based on user actions in the contact record.
Next_Activity_Date Datetime True True

The date of the next upcoming activity for a contact. This is set automatically by HubSpot based on user actions in the contact record.
Number_of_times_contacted Double True True

The number of times a call, email, or meeting was logged for a contact. This is set automatically by HubSpot based on user actions in the contact record.
Number_of_Sales_Activities Double True True

The number of sales activities for a contact. This is set automatically by HubSpot based on user actions in the contact record.
HubSpot_Owner_Email_legacy_ String False True

A legacy property used to identify the email address of the owner of the contact. This property is no longer in use.
HubSpot_Owner_Name_legacy_ String False True

A legacy property used to identify the name of the owner of the contact. This property is no longer in use.
SurveyMonkey_Event_Last_Updated Double True True

This field is meaningless on its own, and is solely used for triggering dynamic list updates when SurveyMonkey information is updated
Webinar_Event_Last_Updated Double True True

This field is meaningless on its own, and is solely used for triggering dynamic list updates when webinar information is updated
City String False True

A contact's city of residence
Time_Last_Seen Datetime True True

The last time and date a contact has viewed a page on your website.
Last_marketing_email_click_date Datetime True True

The date of the most recent link click for any marketing email to the current email address. This is automatically set by HubSpot.
Google_Plus_Clicks Double True True

The number clicks on links shared on Google Plus
HubSpot_Team String True True

The team of the owner of a contact.
LinkedIn_Bio String False True

A contact's LinkedIn bio
Twitter_Bio String False True

The contact's Twitter bio. This is set by HubSpot using the contact's email address.
All_owner_ids String True True

The value of all owner referencing properties for this object, both default and custom
Time_of_Last_Session Datetime True True

The last time and date a contact visited your website.
First_marketing_email_send_date Datetime True True

The date of the earliest delivery for any marketing email to the current email address. This is automatically set by HubSpot.
Broadcast_Clicks Double True True

The number of clicks on published social messages. This is set automatically by HubSpot for each contact.
State_Region String False True

The contact's state of residence. This might be set via import, form, or integration.
All_team_ids String True True

The team ids corresponding to all owner referencing properties for this object, both default and custom
Original_Source String False True

The first known source through which a contact found your website. Source is automatically set by HubSpot, but may be updated manually.
First_marketing_email_open_date Datetime True True

The date of the earliest open for any marketing email to the current email address. This is automatically set by HubSpot.
Postal_Code String False True

The contact's zip code. This might be set via import, form, or integration.
Country_Region String False True

The contact's country/region of residence. This might be set via import, form, or integration.
All_accessible_team_ids String True True

The team ids, including up the team hierarchy, corresponding to all owner referencing properties for this object, both default and custom
Original_Source_DrillDown_1 String True True

Additional information about the source through which a contact first found your website. This property is automatically set by HubSpot.
First_marketing_email_click_date Datetime True True

The date of the earliest link click for any marketing email to the current email address. This is automatically set by HubSpot.
LinkedIn_Connections Double False True

How many LinkedIn connections they have
Original_Source_DrillDown_2 String True True

Additional information about the source through which a contact first found your website. This property is automatically set by HubSpot.
Is_globally_ineligible Bool True True

Indicates the contact is globally ineligible for email.
Preferred_language String False True

Set your contact's preferred language for communications. This property can be changed from an import, form, or integration.
Klout_Score Double False True

A contact's Klout score, a measure of Internet influence
First_Referring_Site String True True

The first website that referred a contact to your website. This is automatically set by HubSpot for each contact.
Job_Title String False True

A contact's job title
Photo String False True

Social Media photo
Last_Referring_Site String True True

The last website that referred a contact to your website. This is automatically set by HubSpot for each contact.
Message String False True

A default property to be used for any message or comments a contact may want to leave on a form.
Close_Date Datetime False True

The date that a contact became a customer. This property is set automatically by HubSpot when a deal or opportunity is marked as closed-won. It can also be set manually or programmatically.
Average_Pageviews Double True True

The average number of pages a contact sees. This is automatically set by HubSpot for each contact.
Event_Revenue Double True True

Event revenue can be set on a contact though HubSpot's enterprise Events. http://help.hubspot.com/articles/KCS_Article/Reports/How-do-I-create-Events-in-HubSpot
Became_a_Lead_Date Datetime True True

The date when a contact's lifecycle stage changed to Lead. This is automatically set by HubSpot for each contact.
Became_a_Marketing_Qualified_Lead_Date Datetime True True

The date when a contact's lifecycle stage changed to MQL. This is automatically set by HubSpot for each contact.
Became_an_Opportunity_Date Datetime True True

The date when a contact's lifecycle stage changed to Opportunity. This is automatically set by HubSpot for each contact.
Lifecycle_Stage String False True

The qualification of contacts to sales readiness. It can be set through imports, forms, workflows, and manually on a per contact basis.
Became_a_Sales_Qualified_Lead_Date Datetime True True

The date when a contact's lifecycle stage changed to SQL. This is automatically set by HubSpot for each contact.
Create_Date Datetime True True

The date that a contact entered the system
Became_an_Evangelist_Date Datetime True True

The date when a contact's lifecycle stage changed to Evangelist. This is automatically set by HubSpot for each contact.
Became_a_Customer_Date Datetime True True

The date when a contact's lifecycle stage changed to Customer. This is automatically set by HubSpot for each contact.
HubSpot_Score Double True True

The number that shows qualification of contacts to sales readiness. It can be set in HubSpot's Lead Scoring app.
Company_Name String False True

The name of the contact's company. This is separate from the Name property of the contact's associated company and can be set independently.
Became_a_Subscriber_Date Datetime True True

The date when a contact's lifecycle stage changed to Subscriber. This is automatically set by HubSpot for each contact.
Became_an_Other_Lifecycle_Date Datetime True True

The date when a contact's lifecycle stage changed to Other. This is automatically set by HubSpot for each contact.
Website_URL String False True

The contact's company website
Number_of_Employees String False True

The number of company employees
Annual_Revenue String False True

Annual company revenue
Industry String False True

The industry a contact is in
Associated_Company_ID Double False True

The HubSpot defined ID of a contact's associated company in HubSpot
Associated_Company_Last_Updated Double True True

This field is meaningless on its own, and is solely used for triggering dynamic list updates when a company is updated
Lead_Rating String True True

The rating of this contact based on their predictive lead score
Predictive_Lead_Score Double True True

A score calculated by HubSpot that represents a contact's likelihood to become a customer