Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.hubspot.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Identify a visitor by email address. This links the visitor’s usertoken to their email address, allowing HubSpot to update an existing contact record or create a new one.
You should only use the identify method when you know the identity (i.e. the email address) of the person viewing the page. Using a placeholder email for unknown visitors will create a contact record with that placeholder email.

​
Usage

var _hsq = (window._hsq = window._hsq || []);
_hsq.push([
  "identify",
  {
    email: "visitor@example.com",
    firstname: "John",
    lastname: "Doe",
  },
]);

​
Notes

  • The identify function only sets the identities in the tracker.
  • The identities do not get passed to HubSpot until you make a separate trackPageView or trackEvent call.
  • HubSpot validates the email address used for any process that would create or update a contact record.
Last modified on May 5, 2026