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

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

C1 provides identity governance for Shortcut. Integrate your Shortcut
workspace with C1 for unified visibility and governance over members and
group membership.

## Capabilities

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

The connector reads workspace members and groups from Shortcut. Each group
exposes a `member` entitlement; the connector syncs which members belong to
each group. Each member's workspace role (such as Owner, Admin, or Member) is
recorded as a profile attribute.

This connector is read-only. It does not provision or modify access in
Shortcut.

## Gather Shortcut credentials

<Warning>
  Create a Shortcut API token scoped to the workspace you want to sync. The
  connector only reads members and groups — write scope is not required.
</Warning>

<Steps>
  <Step>
    In Shortcut, open your account settings and go to
    **[API Tokens](https://app.shortcut.com/settings/account/api-tokens)**.
  </Step>

  <Step>
    Generate a new API token. The token scopes the connector to the workspace
    it was created in.
  </Step>

  <Step>
    Copy the token value. You enter it as the **API token** when configuring
    the connector.
  </Step>
</Steps>

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

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

        * **API token**: The API token you copied above.
        * **API base URL**: `https://api.app.shortcut.com`
      </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 Shortcut connector is now pulling access data into C1.
  </Tab>

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

    <Steps>
      <Step>
        Create a secret for the Shortcut API token.
      </Step>

      <Step>
        Configure the connector environment variables:

        ```bash theme={"theme":{"light":"css-variables","dark":"css-variables"}}
        BATON_BASE_URL=https://api.app.shortcut.com
        BATON_API_TOKEN=<Shortcut API token>
        ```
      </Step>

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

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

## Connector configuration reference

| Setting      | Environment variable | Required | Description                                                             |
| ------------ | -------------------- | -------- | ----------------------------------------------------------------------- |
| API token    | `BATON_API_TOKEN`    | Yes      | Shortcut workspace API token from account settings. Stored as a secret. |
| API base URL | `BATON_BASE_URL`     | Yes      | Shortcut API host root, usually `https://api.app.shortcut.com`.         |