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

# ABBYY Vantage Connector for Microsoft Power Automate

> Install and configure the ABBYY Vantage custom connector for Microsoft Power Automate, including OAuth 2.0 security setup and connection testing.

The ABBYY Vantage connector for Microsoft Power Automate allows developers to add data extraction and document classification functionality to automation flows. This is a redistributable package for manual installation.

## Prerequisites

<Note>
  A premium Power Automate license is required to use this connector.
</Note>

You will need a Vantage tenant with a [Public API Client](/vantage/documentation/tenant-admin/tenant-management/configure-client) configured.

Configure these settings for this connector:

* **Authorized Redirect URL**: Obtained from Power Automate further in this setup guide. Keep the abbyy.com redirect URL.
* **Client ID**: Your Public API Client ID.
* **Client Secret**: Your Client Secret.
* Disable **Require PKCE for Authorization Code Flow**.
* Enable **Allow issuing refresh tokens to refresh access tokens**.
* Enable **Allow client credentials flow**. For Role(s), select `Skill User`.

<Frame caption="Example configured API Client">
  <img src="https://mintcdn.com/abbyy/YpqdJk1A1n7Rrt8K/images/vantage/developer/connectors/ms-powerautomate/public-api-client.jpg?fit=max&auto=format&n=YpqdJk1A1n7Rrt8K&q=85&s=d425aa3ac98d861d817edb2811d6023c" alt="ABBYY Vantage Public API client screen" width="1684" height="1688" data-path="images/vantage/developer/connectors/ms-powerautomate/public-api-client.jpg" />
</Frame>

### Find the Tenant ID

You will need the Vantage Tenant ID during the security configuration step.

<Steps>
  <Step title="Open the tenant configuration">
    In Vantage, click **Configuration** in the left pane.
  </Step>

  <Step title="Copy the Tenant ID">
    Click **General** and find the **Tenant ID** field.

    <Frame>
      <img src="https://mintcdn.com/abbyy/YpqdJk1A1n7Rrt8K/images/vantage/developer/connectors/ms-powerautomate/finding-tenant-id.jpg?fit=max&auto=format&n=YpqdJk1A1n7Rrt8K&q=85&s=9797a2c9bf66dfa4ba7e4319c9717f4b" alt="ABBYY Vantage Tenant Configuration screen" width="1414" height="610" data-path="images/vantage/developer/connectors/ms-powerautomate/finding-tenant-id.jpg" />
    </Frame>
  </Step>
</Steps>

## Install the connector

First, [download the connector](https://www.abbyy.com/marketplace/assets/host/abbyy/connector/microsoft-power-automate/) from the ABBYY Marketplace.

<Steps>
  <Step title="Open Custom connectors">
    In Microsoft Power Automate, select **Data > Custom connectors** from the menu on the left. You may need to select **More** to find the option.
  </Step>

  <Step title="Create a custom connector">
    Click **+ New custom connector** and select **Import an OpenAPI file**.
  </Step>

  <Step title="Name the connector">
    Enter a name for the connector, such as `ABBYY Vantage`.
  </Step>

  <Step title="Import the OpenAPI file">
    Browse for the `ABBYY-Vantage-ProcessingAPI.swagger.json` file and open it.
  </Step>
</Steps>

### Configure general information

<Steps>
  <Step title="Upload a connector icon (optional)">
    Upload a connector icon using the ABBYY Vantage logo (`Vantage-Square-icon.png`) included in the connector download.
  </Step>

  <Step title="Set the Host URL">
    Change the **Host** URL to your Vantage server address. Use the same host address in the **Authorization URL** and **Token URL** fields.
  </Step>
</Steps>

<CodeGroup>
  ```text US theme={null}
  vantage-us.abbyy.com
  ```

  ```text EU theme={null}
  vantage-eu.abbyy.com
  ```

  ```text AU theme={null}
  vantage-au.abbyy.com
  ```
</CodeGroup>

### Configure security

Set **Authentication type** to **OAuth 2.0** and fill in the following fields using the values from your Vantage Public API Client. Select your tenant region in the URL fields below and replace `[tenant-id]` with your tenant identifier:

* **Client ID**: Your Public API Client ID.

* **Client secret**: Your Public API Client secret.

* **Authorization URL**:

  <CodeGroup>
    ```text US theme={null}
    https://vantage-us.abbyy.com/auth2/[tenant-id]/connect/authorize
    ```

    ```text EU theme={null}
    https://vantage-eu.abbyy.com/auth2/[tenant-id]/connect/authorize
    ```

    ```text AU theme={null}
    https://vantage-au.abbyy.com/auth2/[tenant-id]/connect/authorize
    ```
  </CodeGroup>

* **Token URL**:

  <CodeGroup>
    ```text US theme={null}
    https://vantage-us.abbyy.com/auth2/[tenant-id]/connect/token
    ```

    ```text EU theme={null}
    https://vantage-eu.abbyy.com/auth2/[tenant-id]/connect/token
    ```

    ```text AU theme={null}
    https://vantage-au.abbyy.com/auth2/[tenant-id]/connect/token
    ```
  </CodeGroup>

* **Refresh URL**:

  <CodeGroup>
    ```text US theme={null}
    https://vantage-us.abbyy.com/auth2/[tenant-id]/connect/token
    ```

    ```text EU theme={null}
    https://vantage-eu.abbyy.com/auth2/[tenant-id]/connect/token
    ```

    ```text AU theme={null}
    https://vantage-au.abbyy.com/auth2/[tenant-id]/connect/token
    ```
  </CodeGroup>

* **Scope**: `openid permissions global.wildcard offline_access`

Finalize the security configuration with the following steps.

<Steps>
  <Step title="Create the connector">
    Click **Create Connector** at the top of the page to create the connector and generate the Redirect URL.
  </Step>

  <Step title="Add the Redirect URL to Vantage">
    Copy the Redirect URL. In your Vantage Public API Client under **Authorized Redirect URLs**, click **Add Redirect URL** and paste the URL.
  </Step>

  <Step title="Update the OAuth 2.0 flow settings">
    In your Vantage Public API Client under **OAuth 2.0 Flows Settings**:

    * Disable **Require PKCE for Authorization Code Flow**.
    * Enable **Allow issuing refresh tokens to refresh access tokens**.
  </Step>
</Steps>

## Create a connection

On the **Test** tab, choose **New Connection**. A pop-up login window opens. Enter your ABBYY Vantage username and password. Be sure to choose the same account that contains the Public API Client for Microsoft Power Automate.

## Test the connection

After successfully logging into your Vantage account, the new connection appears in the Connections list. Verify that the connector is functioning properly by testing an operation. Select `ListAllAvailableSkills` from the Operations list and click **Test operation**. If it doesn't work, review the previous steps to ensure all fields have been configured correctly.

## Import demo flows

For more information, see [Sample process for the Power Automate connector](/vantage/connectors/ms-powerautomate/sample-process).

## Modify flows

You can modify a demo flow or create your own. If you need to work with a specific data set from a JSON-based response, you can modify the JSON schema. To get the JSON schema, open the Swagger UI and call the required method. The Swagger UI is available at:

<CodeGroup>
  ```text US theme={null}
  https://vantage-us.abbyy.com/api/index.html?urls.primaryName=publicapi%2Fv1
  ```

  ```text EU theme={null}
  https://vantage-eu.abbyy.com/api/index.html?urls.primaryName=publicapi%2Fv1
  ```

  ```text AU theme={null}
  https://vantage-au.abbyy.com/api/index.html?urls.primaryName=publicapi%2Fv1
  ```
</CodeGroup>

## Next steps

View the [release notes](/vantage/connectors/ms-powerautomate/release-notes) for the Microsoft Power Automate connector.