Generate a visitor identification token

POST

visitor-identification

tokens

create

Generate visitor token

curl --request POST \
  --url https://api.hubapi.com/visitor-identification/v3/tokens/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>",
  "hsCustomerAgentContext": {},
  "firstName": "<string>",
  "lastName": "<string>"
}
'

{
  "token": "<string>"
}

Supported products

Required Scopes

Authorizations

Authorization

string

header

required

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

Body

application/json

string

required

The email of the visitor that you wish to identify

hsCustomerAgentContext

object

required

Show child attributes

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 March 30, 2026

⌘I