---
title: BeyondTrust Access Requirements
excerpt: ''
deprecated: false
hidden: false
metadata:
  title: ''
  description: ''
  robots: index
next:
  description: ''
---
> ✅ As Moveworks has integrated with BeyondTrust, we would need the following details to connect our services with your BeyondTrust instance. Our systems will generate a session key, and utilize that key to generate a new session for users to connect to your Agents via the BeyondTrust portal.

# General Setup

***

You will need to collect the following to configure the Connector in Moveworks Setup.

* [ ]  Client ID
* [ ]  Client Secret
* [ ]  URL of your BeyondTrust instance
* [ ]  ID for the representative, or team queue in which you wish to place this session.
* [ ]  (Optional) CodeName of the selected issue (if any)

👉 Provide the Queue ID and the CodeName (if any) from the above to your Moveworks Customer Success team via an encrypted email.

## Setup an API Account

To provide API access to your BeyondTrust instance, you would need to follow the below steps and configure an API account for Moveworks.

> 📘 You must first login to your BeyondTrust instance as an **Admin** or have access to the Management tab to complete the following steps.

1. Go to the **Management** section of your BeyondTrust instance
2. Navigate to the **API Configuration** section
3. Click on the checkbox to **Enable XML API** if that is not already enabled
4. Click on `+ADD` to add a new API Account
5. Make sure the following fields are filled or selected:
   1. **Enabled**: check
   2. **Name**: `Moveworks Live Agent Integration`
   3. **Permissions**:
      1. Command API → Full Access (This is required to generate a session key)
6. Note down the OAuth Client ID and Client Secret in a secured location.

![](https://files.readme.io/1d9e0a99ef2fddc31f820bb2ef844ec693f674a99dcb780cab35ffb2977ad30e-Screenshot_2024-10-08_at_12.19.09_PM.png)

***

<br />

## Configure the Connector in Moveworks Setup

1. Within Moveworks Setup, go to **Manage Connectors** > **System Connectors**, then click on **‘CREATE NEW’**

   ![](https://files.readme.io/c7e70553dc3281a82b99e37c37fae3bc57e18ec32db675ae726398a3d661fbfe-Screenshot_2025-01-23_at_7.08.59_PM.png)
2. Click on the **‘Beyond Trust’** Connector, then click on **‘NEXT: ADD CREDS’**

   ![](https://files.readme.io/328c0b657f735b110527befd66891704590ecadef8c04454a5305ca42bd300dd-Screenshot_2025-01-23_at_7.12.57_PM.png)
3. Type out the name of the connection, select Common Base URL and enter the base URL of your instance.
4. Select the Authentication Type as **Oauth2 Client Credentials Auth**
5. Enter the **Client ID** and **Client Secret** that you generated previously in the respective fields and save the Connector.

   ![](https://files.readme.io/46638ccc3154c66e63695f738b2172331ad0c997c18e382fe93429182045abd2-image.png)

Your BeyondTrust Connector is now ready to be configured for Live Agent API Handoff using Moveworks Setup.

##