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

# Set up a Buddy connector

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

C1 provides identity governance for Buddy. Integrate your Buddy
workspace with C1 for unified visibility and governance over user access.

## Capabilities

| Resource  | Sync                                                          | Provision |
| --------- | ------------------------------------------------------------- | --------- |
| Workspace | <Icon icon="square-check" iconType="solid" color="#c937ae" /> |           |
| Members   | <Icon icon="square-check" iconType="solid" color="#c937ae" /> |           |
| Groups    | <Icon icon="square-check" iconType="solid" color="#c937ae" /> |           |

The connector syncs a single Buddy workspace, its members, and its groups. It
maps workspace membership and group membership as access grants. For each group
member it records whether they are a member or a manager of the group, and it
surfaces a member's workspace-level admin and owner flags as member attributes.

## Gather Buddy credentials

<Warning>
  The connector reads your workspace, its members, and its groups, so the access
  token must belong to a user who can view workspace members and groups. On the
  **Free** plan, the workspace must also have the **Enable developer API** setting
  turned on before any token can call the API.
</Warning>

<Steps>
  <Step>
    Sign in to Buddy and open your profile **Settings**.
  </Step>

  <Step>
    Go to **Personal access tokens** and create a new token with the scopes
    needed to read the workspace and its members (at minimum the workspace and
    member-read scopes).
  </Step>

  <Step>
    Copy the generated token.
  </Step>

  <Step>
    Note your workspace **domain** — the short identifier in your workspace URL
    `https://app.buddy.works/<domain>/...`, not the display name.
  </Step>
</Steps>

## Configure the Buddy 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 **Integrations** > **Connectors** and click **Add connector**.
      </Step>

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

      <Step>
        Choose how to set up the new Buddy connector.
      </Step>

      <Step>
        Set the owner for this connector.
      </Step>

      <Step>
        Click **Next**.
      </Step>

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

      <Step>
        Enter the Buddy credentials:

        * **Buddy Base URL**: The API host for your account. Enter
          `https://api.buddy.works` for the US cloud, `https://api.eu.buddy.works`
          for the EU region, or your self-hosted instance origin with the `/api`
          suffix (for example `https://buddy.example.com/api`).
        * **Buddy API Token**: Your personal access token.
        * **Buddy Workspace Domain**: The short workspace domain to sync.
      </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 Buddy connector is now pulling access data into C1.
  </Tab>

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

    <Steps>
      <Step>
        Create secrets for the Buddy credentials.
      </Step>

      <Step>
        Configure the connector with:

        * **Buddy Base URL**: The API host for your account —
          `https://api.buddy.works` (US), `https://api.eu.buddy.works` (EU), or
          your self-hosted instance origin with the `/api` suffix.
        * **Buddy API Token**: Your personal access token.
        * **Buddy Workspace Domain**: The short workspace domain to sync.
      </Step>

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

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