# userVerificationAPI

This object contains all the APIs associated with user verification. See [User Verification](/docs/service/messaging-web/guide/user-verification.md).

## clearSession

This method clears all messaging and user data from all tabs and windows.

### Parameters

Optional. To end the session for authenticated conversations, set `shouldEndSession` to `true`. To remove messaging components for unauthorized sessions, use the [`removeAllComponents`](/docs/service/messaging-web/references/m4w-reference/utilAPI.md#removeallcomponents) API. The default is `false`.

### Example

```javascript
embeddedservice_bootstrap.userVerificationAPI
  .clearSession(true)
  .then(() => {
    // TO DO: Handle success
  })
  .catch((error) => {
    // TO DO: Handle error
  })
  .finally(() => {
    // TO DO: Handle regardless of result
  });
```

## `setIdentityToken({parameters})`

This method passes the user verification token to Salesforce. You must call this method for every tab or window that requires access to the authorized messaging conversation. Since the token is stored in the browser’s memory, call this method after a page refresh. Also, call this method with a renewed token when the token expires (see [`onEmbeddedMessagingIdentityTokenExpired`](/docs/service/messaging-web/guide/event-listeners.md)). You can also call this method before the token expires to renew the token proactively. This method must be called after the [`onEmbeddedMessagingReady`](/docs/service/messaging-web/guide/event-listeners.md) event is dispatched.

### Parameters

`{parameters}`: Required. A JSON object containing the identity token information.

| Parameter         | Type   | Description                                                                       |
| ----------------- | ------ | --------------------------------------------------------------------------------- |
| identityTokenType | string | The type of identity that is being provided. Currently, this value must be `JWT`. |
| identityToken     | string | The user identity token encoded using the RS256 algorithm.                        |

### Example

```javascript
embeddedservice_bootstrap.userVerificationAPI.setIdentityToken({
  identityTokenType: "JWT",
  identityToken: customer_signed_jwt,
});
```