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"
}

POST

visitor-identification

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"
}

サポートされる製品

次のいずれかの製品またはそれ以上が必要です。

Marketing HubProfessional

Sales HubProfessional

Service HubProfessional

Content HubProfessional

必須スコープ

この API には、次のいずれかのスコープが必要です。

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

string

required

特定する訪問者のEメールアドレス

Example:

"visitor-email@example.com"

firstName

string

特定する訪問者の名。この値は新規コンタクトおよび名の値がない既存のコンタクトについてのみHubSpotで設定されます。必須ではありません。

Example:

"Gob"

lastName

string

特定する訪問者の姓。この値は新規コンタクトおよび姓の値がない既存のコンタクトについてのみHubSpotで設定されます。必須ではありません。

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"