> ## Documentation Index
> Fetch the complete documentation index at: https://docs.refold.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup

> Connect to your OpenText app for OAuth.

To setup your OpenText app in Refold for OAuth, you will need the following credentials from your [OpenText Developer account](https://developer.opentext.com/):

* Client ID
* Client Secret

### Pre-requisites

1. OpenText Developer account. You can create one [here](https://ui.otiam.opentext.com/#/walkup).
2. Signed up for Free (Trial) of **Services Bundle** in [plans](https://developer.opentext.com/plans).

<Info>If you haven't already created an app in OpenText, you'd need to create one.</Info>

### Creating an app in OpenText

To create a OpenText app and acquire the above mentioned credentials, please follow the steps mentioned below:

1. Log in to your [OpenText Admin Center Console](https://developer.opentext.com/).
2. Click on the `Apps` option under **App Management** in the side menu and click on `+ Add` button > `Add new standalone app`.

<img height="200" src="https://mintcdn.com/cobalt-55/JZIwRzAqkgW8vPoP/images/Opentext/opentext_navigation.png?fit=max&auto=format&n=JZIwRzAqkgW8vPoP&q=85&s=25b6edf18ff965e17ae62fc4e979949b" alt="Navigation for App setup" data-path="images/Opentext/opentext_navigation.png" />

3. Enter the `Display Name`, unique `App Name`, `Version` and `Description` for your application and click on `Save`.
4. Copy the **Client ID** and **Client Secret** from the `Confidentials Credentials` section.

<img height="200" src="https://mintcdn.com/cobalt-55/JZIwRzAqkgW8vPoP/images/Opentext/opentext_credentials.png?fit=max&auto=format&n=JZIwRzAqkgW8vPoP&q=85&s=995742470054349f0e56c498f921cfc9" alt="Getting Credentials" data-path="images/Opentext/opentext_credentials.png" />

5. Go to your [`Apps catalog`](https://app.gocobalt.io/apps) in **Refold** > Search for `OpenText` > `Settings` > `Use your credentials` > `Callback Url` > Copy it.
6. In the app created in OpenText, navigate to `Service Clients` in the side menu > Select the app with matching Client ID that you received in Step 4 > Click on `Manage Redirect URLs` > `Add URL` > Paste the Callback URL and click on `Save`.

<img height="200" src="https://mintcdn.com/cobalt-55/JZIwRzAqkgW8vPoP/images/Opentext/opentext_config.png?fit=max&auto=format&n=JZIwRzAqkgW8vPoP&q=85&s=83df66c3710acd4e3e5802563bb4af41" alt="Setting up Developer app" data-path="images/Opentext/opentext_config.png" />

7. Now navigate to `Subscriber Tenants` option in the side menu and click on `Add to tenant`. Add all the tenants here for which you want to enable the OAuth app and click on `Add`.

<Note>
  This step is necessary, otherwise the tenant will not be able to perform Auth with the app.
</Note>

#### Configuring credentials in Refold

App settings page lets you configure the authentication settings for an `OAuth 2.0` based application. For your customers to provide you authorization to access their data,
they would first need to install your application. This page lets you set up your application credentials.

<img height="200" src="https://mintcdn.com/cobalt-55/wOGvLSncBaYd4o6C/images/Opentext/opentext_cobalt.png?fit=max&auto=format&n=wOGvLSncBaYd4o6C&q=85&s=1e2e15cb66f62ca033ba3c13289b1a17" alt="Setting up application client credentials" data-path="images/Opentext/opentext_cobalt.png" />

Provide the acquired Client ID and Client Secret under Settings of the app and save it.

#### Actions and triggers

Once the above setup is completed, you can create orchestrations of your use-cases using OpenText actions and triggers. Following are the set of OpenText actions and triggers
supported by Refold.

<Tabs>
  <Tab title="Actions">
    <AccordionGroup>
      <Accordion title="Documents">
        1. **List Documents** - Get all documents in OpenText.
        2. **Create Document** - Create a document in OpenText.
      </Accordion>

      <Accordion title="Files">
        3. **List Files** - List all files in OpenText.
        4. **Create File** - Create a file instance in OpenText.
        5. **Delete File** - Delete file instance in OpenText.
      </Accordion>

      <Accordion title="Folders">
        6. **List Folders** - List all folders in OpenText.
        7. **Create Folder** - Create a folder instance in OpenText.
        8. **Delete Folder** - Delete folder instancen in OpenText.
      </Accordion>

      <Accordion title="Others">
        9. **HTTP Request** - Make HTTP API calls to any OpenText documented REST APIs.
        10. **List Categories** - List all categories in OpenText.
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Triggers">
    There are no triggers in this application.
  </Tab>
</Tabs>
