Zum Hauptinhalt springen
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"
}
サポートされる製品
次のいずれかの製品またはそれ以上が必要です。
Marketing HubMarketing HubProfessional
Sales HubSales HubProfessional
Service HubService HubProfessional
Content HubContent 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

​
email
string
required

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

Example:

"email@example.com"

​
firstName
string

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

Example:

"Tobias"

​
lastName
string

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

Example:

"Fünke"

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"

⌘I