Skip to content

HubSpot: Visitor identification schemas

2 HubSpot schemas with complete fields and constraints.

← Visitor identification operations · All schemas

Generate visitor token — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
emailstringRequired within parentThe email of the visitor that you wish to identify
firstNamestringOptionalThe first name of the visitor that you wish to identify. This value will only be set in HubSpot for new contacts and existing contacts where first name is unknown. Optional.
hsCustomerAgentContextobjectRequired within parentAn object containing additional context about the customer agent. This field is required and can include various string properties.
Additional keys: see wildcard field
hsCustomerAgentContext.*stringAdditional keys
lastNamestringOptionalThe last name of the visitor that you wish to identify. This value will only be set in HubSpot for new contacts and existing contacts where last name is unknown. Optional.

Generate visitor token — response body

FieldTypePresenceDescription and constraints
$objectRoot
tokenstringRequired within parentAn identification token that allows the visitor to be treated as a known contact.

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.