> ## 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 Deskpro connector

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

C1 provides identity governance for Deskpro. Integrate your Deskpro
instance with C1 for unified visibility and governance over agent access.

## Capabilities

| Resource                  | Sync                                                          | Provision |
| ------------------------- | ------------------------------------------------------------- | --------- |
| Users (agents)            | <Icon icon="square-check" iconType="solid" color="#c937ae" /> |           |
| Teams                     | <Icon icon="square-check" iconType="solid" color="#c937ae" /> |           |
| Roles (permission groups) | <Icon icon="square-check" iconType="solid" color="#c937ae" /> |           |

The connector syncs your Deskpro agents as users, your agent teams and
permission groups, and each agent's team and permission-group memberships. It is
read-only and does not provision access.

## Gather Deskpro credentials

<Warning>
  To configure the Deskpro connector, you need administrator access to your
  Deskpro account so you can create an API key.
</Warning>

<Steps>
  <Step>
    In Deskpro, go to **Admin** > **Apis & Integrations** > **API Keys**.
  </Step>

  <Step>
    Create a new API key. Grant it permission to read agents, agent teams, and
    agent groups.
  </Step>

  <Step>
    Copy the generated key. Deskpro keys have the form `<id>:<token>` (for
    example, `1:ABCDEF0123456789`). Also note your Deskpro account URL, which is
    `https://<your-subdomain>.deskpro.com`.
  </Step>
</Steps>

## Configure the Deskpro 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 **Deskpro** and click **Add**.
      </Step>

      <Step>
        Choose how to set up the new Deskpro 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 Deskpro credentials:

        * **Deskpro API base URL**: Your full Deskpro API URL including the
          `/api/v2` suffix, for example
          `https://yourcompany.deskpro.com/api/v2`.
        * **Deskpro API key**: The API key you created, in `<id>:<token>` form.
      </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 Deskpro connector is now pulling access data into C1.
  </Tab>

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

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

      <Step>
        Configure the connector environment variables:

        * **BATON\_DESKPRO\_BASE\_URL**: Your full Deskpro API URL including the
          `/api/v2` suffix, for example
          `https://yourcompany.deskpro.com/api/v2`.
        * **BATON\_DESKPRO\_API\_KEY**: The API key you created, in `<id>:<token>`
          form.
      </Step>

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

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