Skip to main content
POST
/
visitor-identification
/
2026-03
/
tokens
/
create
Generate an identification token for a verified website visitor.
curl --request POST \
  --url https://api.hubapi.com/visitor-identification/2026-03/tokens/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>",
  "firstName": "<string>",
  "lastName": "<string>"
}
'
{
  "token": "<string>"
}

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.

Supported products

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
email
string
required

The email of the visitor that you wish to identify

firstName
string

The 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.

lastName
string

The 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.

Response

successful operation

token
string
required

An identification token that allows the visitor to be treated as a known contact.

Last modified on May 1, 2026