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

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

C1 provides identity governance for PlanetScale. Integrate your PlanetScale
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 PlanetScale credentials

<Warning>
  Create the service token as an organization administrator so it can be granted
  organization-wide read access. The connector is read-only and needs the
  `read_organization` access grant.
</Warning>

<Steps>
  <Step>
    In PlanetScale, open **Organization settings** > **Service tokens**.
  </Step>

  <Step>
    Create a service token. PlanetScale shows a token **ID** and a token
    **value** — copy both. The value is shown only once.
  </Step>

  <Step>
    Grant the service token the **`read_organization`** access on the
    organizations you want C1 to govern.
  </Step>

  <Step>
    Combine the two halves into a single colon-joined string,
    `<token-id>:<token-value>`. This is the value you enter for the service
    token field below.
  </Step>
</Steps>

## Configuration fields

| Field                       | Required | Description                                                                                 |
| --------------------------- | -------- | ------------------------------------------------------------------------------------------- |
| `planetscale-service-token` | Yes      | The service token as the colon-joined pair `<token-id>:<token-value>`.                      |
| `planetscale-api-url`       | Yes      | Base URL for the PlanetScale API. Use `https://api.planetscale.com` for the standard cloud. |

## Synced resource types

* **Organizations**: every organization the service token can reach. The
  member and admin organization roles are modeled as entitlements on the
  organization.
* **Users**: organization members, projected as user principals.
* **Teams**: organization teams, with team membership as grants.

## Special notes

* Provisioning is not supported in the current build; the connector is
  read-only.
* The service token's organization access determines what is synced. A token
  scoped to one organization syncs that organization; a token with access to
  several syncs all of them.

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

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

        * **Service token (id:token)**: The colon-joined `<token-id>:<token-value>` pair.
        * **API URL**: `https://api.planetscale.com` (or your proxy/sovereign host).
      </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 PlanetScale connector is now pulling access data into C1.
  </Tab>

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

    <Steps>
      <Step>
        In C1, navigate to **Integrations** > **Connectors** and click **Add connector**.
      </Step>

      <Step>
        Search for **Baton** and click **Add**, then set the owner and click **Next**.
      </Step>

      <Step>
        Configure C1 credentials and PlanetScale credentials as environment
        variables:

        ```bash theme={"theme":{"light":"css-variables","dark":"css-variables"}}
        BATON_CLIENT_ID=<C1 client ID>
        BATON_CLIENT_SECRET=<C1 client secret>
        BATON_HOST_ID=baton-planetscale
        BATON_PLANETSCALE_SERVICE_TOKEN=<token-id>:<token-value>
        BATON_PLANETSCALE_API_URL=https://api.planetscale.com
        ```
      </Step>

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

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