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

# Affinity

> Connect Affinity to Adapt to analyze your relationships and pipeline

Connect Affinity to let Adapt analyze your relationship intelligence data, including companies, people, and deal pipeline.

## Set up credentials

You generate an Affinity API key from the Manage Apps page in your Affinity settings. You need the **Generate API Key** permission, and API access requires a Scale, Advanced, or Enterprise plan.

<Steps>
  <Step title="Open Settings">
    Log in to Affinity and open **Settings**.
  </Step>

  <Step title="Go to Manage Apps">
    In the left navigation, select **Manage Apps**.
  </Step>

  <Step title="Create a new API key">
    Click **+ New App** (or **Create New API Key**). Enter a descriptive
    **Name** and an optional **Description** for the integration.
  </Step>

  <Step title="Copy the API key">
    Click **Add App** to generate the key. Copy the secret immediately, as it is
    shown only once, and store it securely.
  </Step>
</Steps>

<Note>
  Each user can have only one active API key at a time. Creating a new key
  revokes the existing one. Keys are also automatically revoked when a user is
  deactivated.
</Note>

## Connect to Adapt

<Steps>
  <Step title="Open Integrations">
    In Adapt, go to **Settings > Integrations**.
  </Step>

  <Step title="Find Affinity">
    Search for **Affinity** and select it from the catalog.
  </Step>

  <Step title="Start the connection">
    Click **Connect** to open the connection form.
  </Step>

  <Step title="Add your credentials">
    Enter the values you gathered above, then click **Add connection**:

    | Secret Name        | Value                 |
    | ------------------ | --------------------- |
    | `AFFINITY_API_KEY` | Your Affinity API key |

    You can rename the connection and choose whether it is shared with your
    organization or kept personal to you.
  </Step>

  <Step title="Test the connection">
    Ask Adapt to list the companies in one of your lists.
  </Step>
</Steps>

### Security

* Credentials are encrypted at rest with AES-256
* The API key inherits the permissions and data access of the user who created it, so use an account scoped to only what you need
* Optionally define an IP allowlist on the key to restrict where it can be used
* Never share the API key publicly or commit it to source control

## Capabilities

Adapt can analyze your Affinity relationships, pipeline, and companies. Use it to review deal flow, surface warm intros, and summarize activity across your network.

### Examples

Pipeline review

```
Summarize the deals in my Affinity pipeline by stage.
```

Relationship lookup

```
Who on my team has the strongest relationship with Acme Corp in Affinity?
```

Company analysis

```
List the companies added to my Affinity deal flow list in the last 30 days.
```

Network summary

```
Show me recent interactions logged in Affinity for contacts at Acme Corp.
```