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

# Reco

> Reco leverages business context to protect sensitive assets shared through Slack, Jira, Microsoft 365, Google Workspace, and more.

## Creating a Reco connection[​](#creating-a-reco-connection "Direct link to Creating a Reco connection")

To create the connection you need:

* An API token
* An API address

### Obtaining the API Token[](#obtaining-the-api-token)

1. Log in to your Reco account and navigate to **Settings** > **User Access and Management**.

   <img src="https://mintcdn.com/blinkops-2/0xoW6hR2qAoSx4nh/img/Reco/Reco1.png?fit=max&auto=format&n=0xoW6hR2qAoSx4nh&q=85&s=770d983ad61d9cfd933364840091267b" alt="Settings" width="3828" height="1911" data-path="img/Reco/Reco1.png" />

2. Go to the **API Access Keys** tab and click **Add API Key**.

   <img src="https://mintcdn.com/blinkops-2/0xoW6hR2qAoSx4nh/img/Reco/Reco2.png?fit=max&auto=format&n=0xoW6hR2qAoSx4nh&q=85&s=2ed8f1e83ad18274912a057bdcb8e842" alt="api_key_reco" width="3828" height="1911" data-path="img/Reco/Reco2.png" />

3. Fill in the API key details:

   * Enter the API Key Name.
   * For the Role, you can choose from [Reco's built-in roles](https://readme.reco.ai/docs/user-roles-and-permissions#role-definitions), or create a [custom role](https://readme.reco.ai/docs/creating-and-managing-custom-roles-rbac) for a more fine-grained resolution.
   * (Optional) Enter an Expiration Date. If left blank, the key never expires.
   * (Optional) Enter Permitted IP Addresses. If left blank, access is allowed from any IP.

   <img src="https://mintcdn.com/blinkops-2/0xoW6hR2qAoSx4nh/img/Reco/Reco3.png?fit=max&auto=format&n=0xoW6hR2qAoSx4nh&q=85&s=d7a88a896c96f4a943ec219751c369d2" alt="add_api_key_reco" width="3826" height="1910" data-path="img/Reco/Reco3.png" />

4. Click **Add**.

5. The new key appears in the list with `Status: Active`. Copy and securely store the key. It will not be visible once you leave the page.

### Creating your connection

1. In the Blink platform, navigate to the **Connections** page > **Add connection**. A New Connection dialog box opens displaying icons of external service providers available.
2. Select the **Reco** icon. A dialog box with name of the connection and connection methods appears.
3. (Optional) Edit the name of the connection. At a later stage you cannot edit the name.
4. Select **API Token** as the method to create the connection.
5. Fill in the parameters:
   * The API token
   * The API address
6. (Optional) Click **Test Connection** to test it.
7. Click **Create connection**. The new connection appears on the **Connections** page.
