POST
/
visitor-identification
/
v3
/
tokens
/
create
Generate a 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": "visitor-email@example.com",
  "firstName": "Gob",
  "lastName": "Bluth"
}'
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}
Produits pris en charge
Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing HubPro
Sales HubSales HubPro
Service HubService HubPro
Content HubContent HubPro

​
Portées requises

Cette API requiert l’une des portées suivantes :
  • conversations.visitor_identification.tokens.create

Authorizations

​
Authorization
string
header
required

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

Body

application/json

Information used to generate a token

​
email
string
required

L'e-mail du visiteur que vous souhaitez identifier

Example:

"visitor-email@example.com"

​
firstName
string

Le prénom du visiteur que vous souhaitez identifier. Cette valeur ne sera définie dans HubSpot que pour les nouveaux contacts et les contacts existants dont le prénom est inconnu. Facultatif.

Example:

"Gob"

​
lastName
string

Le nom de famille du visiteur que vous souhaitez identifier. Cette valeur ne sera définie dans HubSpot que pour les nouveaux contacts et les contacts existants dont le nom de famille est inconnu. Facultatif.

Example:

"Bluth"

Response

successful operation

The identification token to be passed to the Conversations JS API to identify the visitor

​
token
string
required
Example:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"