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

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

C1 provides identity governance for Bugsnag. Integrate your Bugsnag
organization with C1 for unified visibility and governance over user access.

## Capabilities

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

## Gather Bugsnag credentials

<Warning>
  Use a Bugsnag personal auth token that can read the organization's
  collaborators and teams. The token is sent on every request as
  `Authorization: token <your token>`.
</Warning>

<Steps>
  <Step>
    In Bugsnag, open **Settings** > **My account** > **Personal auth tokens**.
  </Step>

  <Step>
    Create a personal auth token. Confirm the account it belongs to can read
    the organization's collaborators and teams.
  </Step>

  <Step>
    Copy the token value. Store it securely; you will paste it into the
    connector settings.
  </Step>

  <Step>
    Find your organization id in Bugsnag under **Settings**, or read it from the
    organization API responses. Build the base URL as
    `https://api.bugsnag.com/organizations/<organization_id>`.
  </Step>
</Steps>

## Configuration fields

| Field       | Required | Description                                                                                                                        |
| ----------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `base-url`  | Yes      | Your Bugsnag organization API base URL, ending in your organization id: `https://api.bugsnag.com/organizations/<organization_id>`. |
| `api-token` | Yes      | A Bugsnag personal auth token with read access to the organization's collaborators and teams.                                      |

## Synced resource types

* **Users**: Bugsnag collaborators in the organization, from `/collaborators`.
* **Teams**: Bugsnag teams in the organization, from `/teams`.
* **Team membership**: each team exposes a `member` entitlement, with grants
  read from `/teams/{team_id}/collaborators`.

## Special notes

* The connector is read-only. It does not invite collaborators or change team
  membership.
* One connector instance covers exactly one Bugsnag organization. The
  organization id is part of the base URL.
* A personal auth token may span multiple organizations. The connector reads
  only the organization named in the base URL.

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

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

        * **Organization API base URL**: `https://api.bugsnag.com/organizations/<organization_id>`.
        * **Personal auth token**: The token you created in Bugsnag.
      </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 Bugsnag connector is now pulling access data into C1.
  </Tab>

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

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

      <Step>
        Configure the connector environment variables:

        ```bash theme={"theme":{"light":"css-variables","dark":"css-variables"}}
        BATON_BASE_URL=https://api.bugsnag.com/organizations/<organization_id>
        BATON_API_TOKEN=<Bugsnag personal auth token>
        ```
      </Step>

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

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