> ## Documentation Index
> Fetch the complete documentation index at: https://conductorone-docs-entitlement-lifecycle-sparse-acl.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up a Pumble connector

> C1 provides identity governance for Pumble. Integrate your Pumble instance with C1 for unified visibility and governance over user access.

C1 provides identity governance for Pumble. Integrate your Pumble
workspace with C1 for unified visibility and governance over who can access
your team chat.

## Capabilities

| Resource    | Sync                                                          | Provision |
| ----------- | ------------------------------------------------------------- | --------- |
| Users       | <Icon icon="square-check" iconType="solid" color="#c937ae" /> |           |
| User groups | <Icon icon="square-check" iconType="solid" color="#c937ae" /> |           |

The connector syncs every workspace member, every user group, and each
group's membership. Members keep their workspace role (Owner, Admin, User,
or Guest) and their active or deactivated state, so deactivated members
remain visible in C1 rather than disappearing.

## Gather Pumble credentials

<Warning>
  You need an Owner or Admin account in Pumble to create an API key that can
  read the whole workspace. A key created by a lower-tier member cannot list
  workspace members or groups.
</Warning>

<Steps>
  <Step>
    Sign in to Pumble as a workspace Owner or Admin.
  </Step>

  <Step>
    Open **Workspace settings** and go to **Add-ons**, then enable and open
    the **API Keys** add-on.
  </Step>

  <Step>
    Generate a new API key and copy it. This single value is the only
    credential the connector needs.
  </Step>
</Steps>

## Configure the Pumble connector

<Tabs>
  <Tab title="Cloud-hosted">
    Follow these instructions to use a built-in, no-code connector hosted by C1.

    <Steps>
      <Step>
        In C1, navigate to **Apps** > **Connectors** and click **Add connector**.
      </Step>

      <Step>
        Search for **Pumble** and click **Add**.
      </Step>

      <Step>
        Choose where to add the connector: **Create a new app**, or **Add to an existing app** (then select the app).

        If you're creating a new app, choose whether to link it to an application discovered from your identity provider: select **Yes** and pick the IdP application, or **No** to continue with just the connector.
      </Step>

      <Step>
        Set the connector's **Name** and, optionally, a **Description**.
      </Step>

      <Step>
        Click the pencil icon next to **Owners** to choose who can configure and manage this connector.
      </Step>

      <Step>
        Click **Add**. The connector is created and its configuration page opens.
      </Step>

      <Step>
        Find the **Settings** area of the page and click **Edit**.
      </Step>

      <Step>
        Enter the Pumble credential:

        * **Pumble API key**: The API key you generated from the Pumble API
          Keys add-on.
      </Step>

      <Step>
        Click **Save**.
      </Step>

      <Step>
        The connector's label changes to **Syncing**, followed by **Connected**. You can view the logs to ensure that information is syncing.
      </Step>
    </Steps>

    **Done.** Your Pumble connector is now pulling access data into C1.
  </Tab>

  <Tab title="Self-hosted">
    Follow these instructions to run the Pumble connector in your own
    environment.

    <Steps>
      <Step>
        Create a secret for the Pumble API key.
      </Step>

      <Step>
        Configure the connector with the credential:

        * **Pumble API key**: The API key you generated from the Pumble API
          Keys add-on.
      </Step>

      <Step>
        Deploy the connector using your standard self-hosted connector process.
      </Step>
    </Steps>

    **Done.** Your Pumble connector is now pulling access data into C1.
  </Tab>
</Tabs>