v1

latestOpenAPI 3.0.12026-07-14145.6 KB

Generate

Generate a token

Generates a new visitor identification token. This token will be unique every time this endpoint is called, even if called with the same email address. This token is temporary and will expire after 12 hours

post/conversations/v3/visitor-identification/tokens/create

Request body

emailstring required

The email of the visitor that you wish to identify

firstNamestring

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.

lastNamestring

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.

Example request

{
  "email": "visitor-email@example.com",
  "firstName": "Gob",
  "lastName": "Bluth"
}

Response

successful operation

tokenstring required

Example response

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}

All 1 operations