--- title: "How to Setup a Relativity® Plus Connector" slug: "how-to-setup-a-relativity-plus-connector" tags: ["relativity ", "plus", "Connector", "oath2"] updated: 2026-02-09T12:34:15Z published: 2026-02-09T12:34:15Z canonical: "docs.revealdata.com/how-to-setup-a-relativity-plus-connector" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.revealdata.com/llms.txt > Use this file to discover all available pages before exploring further. # How to Setup a Relativity® Plus Connector ## Configure a Relativity® OAuth2 Client for a Relativity® Plus Connector Configuring a Relativity®* OAuth2 client is the first step in creating a Brainspace dataset with a Brainspace Relativity® Plus connector for Relativity® v9.7 and newer versions of Relativity®. > [!NOTE] > **Note** > > Relativity® 9.7.229.5 does not support database-backed authorization codes with load-balanced web servers. Using multiple web servers will result in the Relativity® Plus connector failing to authenticate. This can be resolved by configuring the Relativity® Plus connector to communicate with a single Relativity® web server. To configure a Relativity® OAuth2 client: 1. Open a Relativity® instance in a web browser, type your **username,** and then click the **Continue** button: ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/how-to-setup-a-relativity-plus-connector-image-pskruubr.png) The Relativity® password dialog will open. 2. Type your **password,** and then click the **Login** button: ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/how-to-setup-a-relativity-plus-connector-image-x6vuwgfd.png) The Relativity® Workspaces window will open. 3. Click the **Authentication** menu dropdown arrow, and then click the **OAuth2 Client** option: ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/how-to-setup-a-relativity-plus-connector-image-v74cwb97.png) 4. Click the **New OAuth2 Client** button: ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/how-to-setup-a-relativity-plus-connector-image-h9ooxypx.png) The OAuth2 Client Information dialog will open. 5. Type a **name** for the client. 6. Set OAuth2 Flow to Code. 7. Type the **redirect URL** (fully-qualified domain name) with */oauth* as the URL endpoint: ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/how-to-setup-a-relativity-plus-connector-image-vwtjasle.png) 8. In the Access Token Lifetime field, type a **session timeout value:** ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/how-to-setup-a-relativity-plus-connector-image-rwd7dlj8.png) > [!NOTE] > **Note** > > Relativity® does not issue refresh tokens. If your OAuth2 session exceeds the session timeout value, you must clear your credentials and create a new OAuth2 token. The OAuth2 session timeout can be set to a low value to be more secure, or it can be set to a maximum of one year. 9. Click the **Save** button. The OAuth2 Client Information screen will refresh. ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/how-to-setup-a-relativity-plus-connector-image-rszae4ew.png) 10. Make note of the **Client ID** and **Client Secret** codes. You will need this information when creating the Relativity® Plus connector in Brainspace. After configuring a Relativity® OAuth2 client, you are ready to create a Relativity® Plus connector in Brainspace (see ***Create a Relativity® Plus Connector***). ## Create a Relativity® Plus Connector After configuring a Relativity® OAuth2 client, you are ready to create a Relativity® Plus connector in Brainspace. You will need the Client ID and Client Secret that you created for the Relativity® OAuth2 client. To create a Relativity® Plus connector: 1. In the user dropdown menu, click **Administration:** ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/how-to-setup-a-relativity-plus-connector-image-wj8norti.jpg) The Datasets screen will open. 2. Click the **Connectors** button: ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/how-to-setup-a-relativity-plus-connector-image-oy641g37.png) The Connectors screen will open. 3. Click the **Add Connector** button: ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/how-to-setup-a-relativity-plus-connector-image-tmnbd6t2.png) The Connector menu will open. 4. Click the **Relativity® Plus** option in the menu. The Relativity® Plus connector dialog will open. 5. In the Connector Name field, type a **name** for the connector. 6. In the Relativity® Base Document URL field, type the **Relativity® base URL** that points to the Relativity® domain user-interface (fully-qualified domain name) with /Relativity as the URL endpoint. 7. In the API field, toggle the switch to the **On** position to allow self-signed certificates. 8. In the Brainspace Analytics Fields To Overlay After A Full Build field, click **an option** in the list, and then select all options using the keyboard command **Ctrl-A.** 9. In the Relativity® API Host Machine Name (FQDN) field, type the **fully-qualified domain name** for the Relativity® REST / ObjectManager API. 10. In the HTTPS field, toggle the switch to the **On** position to enable HTTPS. 11. In the Client ID and Client Secret fields, paste or type the **codes** that were generated by Relativity® when you created the OAuth2 client (see Configure a Relativity® OAuth2 Client for a Relativity® Plus Connector). 12. In the Concurrency field, type a **value** (minimum of 2) for the number of threads to use for ingest and mass operations. 13. Optional: Enable the Deletions toggle if you want to delete documents from Brainspace when they’re deleted from a connected Relativity data source. > [!WARNING] > **Important** > > This requires Full Build with Ingest after deletions. Learn more in the [Brainspace Document Deletions (Clawbacks)](/brainspace/docs/brainspace-document-deletions-clawbacks) article. 14. Click the **Test Connector** button. 15. After the connector test is successful, click the **Create Connector** button. The new Relativity® Plus connector will be added to the Connectors screen. After creating a Relativity® Plus connector, you are ready to create a dataset. You can also manage the connector settings or permanently delete the connector from Brainspace at any time. To configure the advanced settings for a Relativity® Plus connector, click the Advanced link in the Relativity® Plus connector dialog. ## Update a Relativity® Plus Connector After creating a Relativity® Plus connector, you can change the connector’s settings at any time. To update a Relativity® Plus connector: 1. In the user dropdown menu, click **Administration:** ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/how-to-setup-a-relativity-plus-connector-image-bngaoxy8.jpg) The Datasets screen will open. 2. Click the **Connectors** button: ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/how-to-setup-a-relativity-plus-connector-image-qojfpivl.png) The Connectors screen will open. 3. Click the **Update Connector** icon: ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/how-to-setup-a-relativity-plus-connector-image-eauetgw8.png) The connector configuration dialog will open. 4. Modify any of the connector options, and then click the **Test connector** button. 5. After the connector test is successful, click the **Create Connector** button. The updated Relativity® Plus connector will refresh on the Connectors screen. After updating a Relativity® Plus connector, you are ready to create a dataset or continue using it for Brainspace datasets. You can also manage the connector settings or permanently delete the connector from Brainspace at any time. To configure the advanced settings for a Relativity® Plus connector, click the Advanced link in the Relativity® Plus connector dialog. ## Delete a Relativity® Plus Connector After creating a Relativity® Plus connector, you can permanently delete it from Brainspace at any time. To delete a Relativity® Plus connector: 1. In the user dropdown menu, click **Administration:** ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/how-to-setup-a-relativity-plus-connector-image-uvecxtbd.jpg) The Datasets screen will open. 2. Click the **Connectors** button: ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/how-to-setup-a-relativity-plus-connector-image-ftmjpge4.png) The Connectors screen will open. 3. Click the **Delete Connector** icon as shown in the following image: ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/how-to-setup-a-relativity-plus-connector-image-gikqxv3d.png) A confirmation dialog will open. 4. Click the **Delete** button. The confirmation dialog will close, and the Relativity® Plus connector will be permanently deleted from Brainspace. > [!NOTE] > **Note** > > This product may only be used by parties with valid licenses for Relativity®, a product of Relativity ODA LLC. Relativity ODA LLC does not test, evaluate, endorse or certify this product. ## Related - [Relativity® Plus Connector - Advanced Options Explained](/relativity-plus-connector-advanced-options-explained.md) - [Connect Relativity® Tags to a Brainspace Dataset](/connect-relativity-tags-to-a-brainspace-dataset.md) - [How to Setup a Relativity® Connector](/how-to-setup-a-relativity-connector.md) - [Brainspace Supported Connectors](/brainspace-supported-connectors.md)