> ## 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 Toggl Track connector

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

C1 provides identity governance for Toggl Track. Integrate your Toggl Track
organization with C1 for unified visibility and governance over who belongs
to which groups.

## Capabilities

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

The connector reads the users in one Toggl Track organization, the groups
defined in that organization, and which users belong to which groups.
Deactivated users are synced and marked as disabled.

## Gather Toggl Track credentials

<Warning>
  The API token inherits the access of the account that owns it. That account
  must be an administrator of the organization you want to read.
</Warning>

<Steps>
  <Step>
    In Toggl Track, open your **Profile** settings and find the **API Token**
    section. Reveal and copy the token. You enter it as the **API token**
    when configuring the connector.
  </Step>

  <Step>
    Find your organization ID. It appears in the URL of the organization
    settings page. You can also list the organizations your token can see:

    ```bash theme={"theme":{"light":"css-variables","dark":"css-variables"}}
    curl -u <api-token>:api_token https://api.track.toggl.com/api/v9/me/organizations
    ```

    Each entry's `id` field is an organization ID. One connector reads one
    organization.
  </Step>
</Steps>

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

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

        * **Toggl Track API URL**: `https://api.track.toggl.com` (no trailing
          slash and no path — the connector adds the API version and
          organization path itself)
        * **Organization ID**: the numeric organization ID you found above.
        * **API token**: the API token you copied above.
      </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 Toggl Track connector is now pulling access data into C1.
  </Tab>

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

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

      <Step>
        Configure the connector environment variables:

        * **BATON\_BASE\_URL**: `https://api.track.toggl.com`
        * **BATON\_ORGANIZATION\_ID**: the numeric organization ID.
        * **BATON\_API\_TOKEN**: the API token.
      </Step>

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

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