# Integrating SailPoint with Condens

Condens is a cloud research repository platform where organizations manage research workspaces, projects, and user access. Each Condens account has users with assigned access roles (for example, Administrator, Contributor, Limited Access Contributor). The Condens connector enables SailPoint to aggregate users from Condens and the access role assigned to each user. This document provides the instructions required to configure a new direct connection between SailPoint and Condens. For a reference to the terminology specific to SailPoint products, refer to [Source and Connector Definitions](<https://documentation.sailpoint.com/saas/help/sources/index.html#source-and-connector-definitions>).

> [!NOTE]
>
> To view the latest features, enhancements, and fixes for all SaaS connectors, refer to the [SaaS Release Notes](<https://community.sailpoint.com/release-notes/saas>) page.

## Supported Features

The Condens connector supports the following:

### Account Management

- Aggregate Users

### Entitlement Management

- Aggregate Access roles

> [!NOTE]
>
> Roles are modeled as an account entitlement on the `role` attribute (not a separate Group schema). There is no separate entitlement aggregation command; role values are collected with account aggregation from `GET /v1/users`. Participants, projects, and sessions are not aggregated by this connector.

> [!IMPORTANT]
>
> Quick Compliance connectors have the following manual aggregation limits within a 24-hour period:
>
> - **Organization Admins**: Limited to 3 manual account or entitlement aggregations per day per source. This limit is cumulative across all admins in the organization.
> - **Regular Users**: Limited to 1 manual account or entitlement aggregation per day per source.
>
> These limits ensure that individual compliance statuses are kept up to date while maintaining continuous compliance monitoring. If you need to run additional aggregations beyond these limits, contact SailPoint Support.

## Prerequisites

Before you configure the Condens connector, ensure the following requirements are met:

1. Sign in to Condens with an Administrator account.
2. Generate an API key in Condens:

   1. Go to **Settings \> API &amp; MCP-Server**.
   2. Select **Create new key**.
   3. Copy and securely store the API key (it is shown only once).
3. Confirm the correct API Base URL for your Condens region.
4. Confirm the API key can call `GET /v1/users` successfully (for example from Condens settings or your internal validation).

### Base URL

Condens hosts data in different regions. You must set the Base URL in SailPoint Connection Settings to match your Condens account region:

| Region | Base URL |
| --- | --- |
| US | `https://api-us.condens.io` |
| EU | `https://api.condens.io` |

**To find your Base URL:**

1. Sign in to Condens.
2. Go to **Settings \> API &amp; MCP-Server**.
3. Use the API base URL shown on that page.

> [!NOTE]
>
> Using the wrong region Base URL causes Test Connection or aggregation to fail even with a valid API token.

> [!NOTE]
>
> - Condens authentication for this connector uses an API Token.
> - All API calls use `Authorization: Bearer <API_TOKEN>`.
> - API keys are long-lived and do not expire unless deleted in Condens.
> - Regenerating or deleting an API key invalidates previous credentials.
> - Only Condens Administrators can create and manage API keys.

## Required Permissions

Use a Condens Administrator to generate the API token used by SailPoint. The API token represents the organization and provides access according to Condens API key permissions. This connector is read-only (aggregation only). It does not create, update, or delete Condens users.

### Membership Access Roles

Access roles are aggregated from the top-level `role` field on each user in the list users response, for example from `GET /v1/users`.

| API Role Value | Condens UI Name | Typical Meaning |
| --- | --- | --- |
| administrator | Administrator | Manages users, workspaces, and account or API settings. |
| contributor | Contributor | Full research collaboration access (analyze data, work in projects). |
| limited\_access\_contributor | Limited Access Contributor | Contributor-style access with more limits (for example no Participant Pool access). |
| full\_access\_viewer | Full Access Viewer | Broad read access to workspace research data; not a full contributor seat. |
| viewer | Viewer | Read-only stakeholder access (for example published insights or magazine); can be invited to specific projects. |

For more information about Condens, refer to the following:

- [Condens website](<https://condens.io/>)
- [Condens API documentation](<https://apidocs.condens.io/>)
- [Condens API help](<https://condens.io/help/integrations/general/condens-api/>)

> [!NOTE]
>
> The linked document is not maintained by SailPoint and is subject to change without notice.